앱 출시하기

샌드박스 앱에서 테스트를 마쳤다면, 콘솔에 앱 번들(.ait) 을 업로드하고 QR코드로 토스앱에서 최종 테스트한 뒤 출시할 수 있어요.

출시 절차

1. 앱 번들 업로드
2. 테스트
3. 검토 요청
4. 출시하기

꼭 확인하세요

실서비스 런칭 전, 샌드박스 앱 + QR 테스트 를 모두 완료해야 검토·출시가 원활해요.

1. 앱 번들 업로드

테스트를 시작하려면 먼저 앱 번들(.ait) 을 업로드하세요.
업로드가 완료되면 워크스페이스 멤버만 접근 가능한 테스트 스킴/QR을 생성할 수 있어요.

주의하세요

앱 번들은 최대 200MB 까지 업로드가 가능해요.

1. 앱인토스 콘솔에서 앱을 선택하고 "앱 출시" 메뉴로 이동해요.
   

2. + 버전 추가하기 → 앱 번들 > 번들 파일 선택에서 .ait 파일 업로드 → 등록을 눌러요.
   

3. 업로드가 완료되면 아래와 같이 표시돼요.
   

2. 테스트

번들이 등록되면 토스앱에서 바로 테스트할 수 있어요.

• 테스트하기 버튼을 누르면 테스트용 QR 코드가 생성돼요.
• QR 코드를 토스앱으로 스캔하면 앱이 실행돼요.
• 워크스페이스 멤버에게 푸시 메시지를 보내 테스트를 유도할 수도 있어요.

접속 조건

아래 조건을 모두 만족해야 테스트 QR 접속이 가능해요.

• 만 19세 이상
• 워크스페이스 멤버
• 토스앱 로그인 완료

3. 검토 요청

테스트를 마쳤다면 검토 요청하기를 눌러 제출하세요. 정상 접수되면 상태가 검토 중으로 표시돼요.

활성화 조건

테스트를 1회 이상 완료해야 검토 요청하기 버튼이 활성화돼요.

검토가 반려된 경우

반려 사유 버튼을 눌러 사유를 확인한 뒤, 수정하기로 앱을 보완해 새 번들 업로드 → 재요청해 주세요.

4. 출시하기

승인되면 출시하기 버튼이 활성화돼요. 눌러서 앱을 공개하세요.
출시가 완료되면 상태가 출시됨으로 표시돼요.

자주 묻는 질문

토스앱에서 미니앱이 안열려요

토스앱 하위 버전에서 오류가 발생할 수 있어요.
최신 버전의 토스앱이 맞는지 확인해주세요.

'잠시 문제가 생겼어요' 문구가 노출되고 있어요

bedrock.config.ts 파일에서 icon 값을 채운 상태에서 빌드된 ait 파일인지 확인해주세요. appInToss 플러그인 내의 brand 값이 모두 포함된 상태여야 합니다.

export default defineConfig({
  // ...
  appsInToss({
    // ...
    brand: {
      // 👈 brand 값에 빈 값이 없도록
    },
  }),
});