앱인토스 미니앱은 코드를 다 쓰기 전에 콘솔에서 먼저 해 둘 일이 있습니다. 개발자센터의 자주 묻는 질문은 등록 절차를 이 순서로 안내합니다.
- 콘솔 가입
- 워크스페이스 만들기
- 사업자 등록
- 앱 등록
- 검토 요청
이 글은 앱 등록까지를 다룹니다. 그 뒤의 개발, 테스트, 출시는 앱인토스 미니앱 개발 흐름에서 이어집니다.
가입 조건과 사업자 등록
콘솔 가입은 토스 비즈니스 회원을 바탕으로 진행합니다. 가입하려면 두 가지가 필요합니다.
- 만 19세 이상
- 본인 명의로 로그인한 토스 앱
사업자 등록은 가입 조건이 아닙니다. 사업자가 없어도 미니앱을 출시할 수 있습니다. 다만 토스 로그인, 토스페이, 인앱 결제, 프로모션, 비즈 월렛처럼 계약이나 정산이 걸린 기능은 사업자 등록과 약관 동의를 마쳐야 쓸 수 있습니다. 인앱 광고는 수익이 일정 금액을 넘기 전까지 등록을 미룰 수 있습니다.
사업자 정보는 워크스페이스의 '내 정보' 메뉴에서 등록합니다. 사업자 등록증의 업종과 미니앱이 제공하는 서비스의 업종이 같아야 하고, 부가가치세 면세 사업자는 등록할 수 없습니다. 자세한 서류는 사업자 등록하기 문서에 있습니다.
워크스페이스와 제작자 이름
워크스페이스는 팀이 함께 미니앱을 관리하는 공간입니다. 사업자당 하나만 만들 수 있고, 이름은 다른 워크스페이스와 겹칠 수 없습니다.
워크스페이스를 만들 때 제작자 이름도 함께 정합니다. 워크스페이스 이름은 팀 안에서 쓰지만, 제작자 이름은 사용자에게 보입니다.
| 항목 | 내용 |
|---|---|
| 보이는 곳 | 미니앱 상세 화면, 사용자 문의에 보내는 답변 |
| 적용 범위 | 그 워크스페이스에서 등록한 미니앱 전체 |
| 규칙 | 공백 포함 10자 이내, 한글·영문·숫자만 |
| 수정 | 워크스페이스의 '내 정보' 메뉴 |
사용자는 제작자 이름을 눌러 같은 제작자의 다른 미니앱도 볼 수 있습니다. 이미 쓰는 회사명이나 브랜드명이 있다면 그대로 쓰는 편이 좋습니다. 토스나 다른 회사 브랜드와 헷갈리는 이름, 과장된 표현, 특수문자와 이모지는 쓸 수 없습니다.
멤버와 권한 나누기
워크스페이스를 만든 사람은 자동으로 대표관리자가 됩니다. 대표관리자는 워크스페이스 운영을 책임지고 서비스 약관에 동의하는 사람입니다. 관리자 중에서만 맡을 수 있고, 나중에 다른 관리자에게 넘길 수 있습니다.
팀원은 '멤버' 메뉴에서 이메일로 초대하고, 초대할 때 권한을 고릅니다.
- 관리자: 워크스페이스 전체를 관리하고 정산 정보까지 봅니다.
- 구성원: 권한을 받은 앱에서만 정보를 조회하고 관리합니다.
멤버 초대는 테스트와도 이어집니다. 콘솔이 만든 QR 코드로 토스 앱에서 미니앱을 열려면 워크스페이스 멤버여야 하고, 토스 앱에 로그인한 만 19세 이상이어야 합니다. 출시 전에 화면을 같이 확인할 팀원은 미리 멤버로 초대해 두세요.
개발 중에도 앱을 먼저 등록합니다
앱은 '앱' 메뉴의 '+등록하기'로 만듭니다. 개발이 끝나지 않은 앱도 먼저 등록할 수 있고, 처음에는 세 가지만 입력하면 됩니다.
- 앱 이름: 토스 앱에 보이는 이름입니다. 나중에 앱 정보에서 바꿀 수 있고, 영문명은 15자 이내의 발음하기 쉬운 명사형으로 짓습니다.
- appName:
intoss://스킴이 이 값으로 미니앱을 찾습니다. 한 번 등록하면 바꾸거나 지울 수 없습니다. - 앱 유형: 게임인지 아닌지 고릅니다. 유형에 따라 뒤에서 입력할 앱 정보가 달라집니다.
나머지 앱 정보는 준비되는 대로 채우면 되고, 항목마다 임시 저장할 수 있습니다.
출시 전에 채울 앱 정보와 API 키
출시하기 전에는 '앱 출시' 메뉴에서 나머지 앱 정보를 입력하고 검토를 요청합니다. 비게임 앱이라면 이런 항목을 미리 준비합니다.
- 앱 번들(
.ait): 콘솔에 올린 뒤 토스 앱 테스트를 한 번 이상 마쳐야 검토를 요청할 수 있습니다. - 부제와 상세 설명: 상세 설명은 사용자가 처음 실행해 핵심 기능을 쓰기까지 무엇을 보고 누르는지 순서대로 씁니다.
- 고객문의 이메일과 앱 검색 키워드
- 카테고리: 비게임은 대분류부터 소분류까지 고릅니다.
- 앱 로고: 600 × 600px 정사각형 PNG입니다. 배경색이 있어야 하고, 둥근 모서리와 사람 얼굴은 쓸 수 없습니다.
- 스크린샷: 선택 사항입니다.
번들을 콘솔에 들어가지 않고 CLI로 올리려면 API 키가 필요합니다. 워크스페이스를 고른 뒤 왼쪽 '키' 메뉴에서 발급하고, 전체 앱이나 특정 앱 단위로 접근 권한을 정할 수 있습니다. CI/CD 명령어로 올리려면 SDK v1.4.0 이상이어야 합니다.
bash
키를 한 번 등록해 두면 배포할 때마다 다시 입력하지 않아도 됩니다. 명령어와 테스트 스킴은 미니앱 테스트하기 문서에, 앱 정보 항목 전체는 미니앱 등록하기 문서에 있습니다.