미니앱 출시

토스앱에서 최종 테스트를 마쳤다면,
앱인토스 콘솔에서 검토를 요청하고 미니앱을 출시할 수 있어요.

1. 사전 점검하기

① 검수 가이드 확인하기

출시 전 반드시 검수 가이드 및 체크리스트를 확인하세요.
게임/비게임 출시 가이드를 모두 확인하여 개발이 완료되었는지 점검해 주세요.
가이드를 준수하지 않으면 검토 단계에서 반려될 수 있어요.

② 앱 번들 업로드 시 주의사항

용량 정책

• 앱 번들은 압축 해제 기준 100MB 이하만 업로드할 수 있어요.
• 이미지, 사운드, 영상 등 모든 리소스를 포함하면 용량을 초과할 수 있어요.
• 리소스 파일은 빌드와 분리하여 관리해 주세요.

권장 사항

• 앱 실행에 필요한 최소한의 리소스만 번들에 포함하세요.
• 대용량 리소스는 외부 스토리지 또는 CDN 다운로드 방식으로 구성하는 것을 권장해요.
• 추가 리소스는 단계적 다운로드(Lazy Loading) 방식을 적용하면 사용자 경험이 더 좋아져요.

2. 검토 요청하기

테스트를 마친 뒤 콘솔의 '검토 요청하기' 버튼을 클릭하면 검토가 시작돼요.
검토는 영업일 기준 최대 3일 소요됩니다.

• 테스트를 1회 이상 완료한 경우에만 검토 요청 버튼이 활성화됩니다.
• 검토 요청은 한 번에 하나의 버전만 제출할 수 있어요.

검토 요청 후 수정이 필요한 버그를 발견한 경우에는
'요청 취소하기' 버튼을 눌러 검토를 취소한 뒤,
수정된 새로운 번들(.ait) 을 업로드하고 다시 검토를 요청하세요.

검토가 반려된 경우

'반려사유 보기' 버튼을 눌러 사유를 확인한 뒤,
문제를 해결하여 새로운 번들을 업로드 후 다시 검토 요청을 진행해 주세요.

반려 사유에 대해 추가로 문의 사항이 있다면 채널톡으로 문의하실 수 있어요.

3. 출시하기

번들이 승인되면 검수 결과가 이메일로 안내돼요.
이후 콘솔에서 '출시하기' 버튼을 클릭하면 미니앱이 사용자에게 공개됩니다.

⚠️ 출시 즉시 전체 사용자에게 반영되므로, 반드시 충분히 테스트한 뒤 출시하세요.

🔍 테스트 환경과 실제 환경 차이 안내

테스트 환경과 실제 라이브 환경의 CORS 정책 및 네트워크 동작이 다를 수 있어요.
특히 아래 기능은 실제 환경에서도 반드시 동작을 다시 확인해 주세요.

• 메모리/리소스 사용량
• 네트워크 요청(CORS)
  • Origin 허용 목록에 다음 도메인을 등록해야 해요.
    • 실제 서비스 환경: https://<appName>.apps.tossmini.com
    • QR 테스트 환경: https://<appName>.private-apps.tossmini.com
• 권한 처리
• 로그인/세션 유지
• 실제 결제·인증 기능

⚠️ 테스트 환경에서는 정상이어도, 실제 환경에서는 오류가 발생할 수 있어요.

4. 출시 후 관리

출시 후에는 앱인토스 콘솔에서 버전 관리와 업데이트를 진행할 수 있어요.
필요에 따라 새 번들을 업로드하거나 기존 버전을 유지·관리할 수 있습니다.

4-1. 새 버전(업데이트) 배포

• 새 기능을 추가하거나 오류를 수정한 경우, 기존과 동일한 방식으로 새 앱 번들(.ait) 을 업로드하세요.
• 업로드된 번들은 다시 검토 요청 → 승인 → 출시 단계를 거쳐요.
• 승인 후 출시하기 버튼을 누르면 새 버전이 기존 앱을 대체해요.

⚠️ 출시된 버전은 즉시 사용자에게 반영되므로, 사전에 충분한 테스트를 진행한 뒤 업로드하세요.

4-2. 이전 버전 유지 및 롤백

• '앱 출시' 메뉴에서 기존에 출시된 버전 목록을 확인할 수 있어요.
• 문제가 발생하면 이전 버전으로 롤백 할 수 있어요.
• 롤백할 버전을 선택한 후 '출시하기' 버튼을 클릭하세요.

⚠️ 롤백 역시 사용자에게 즉시 반영되므로, 버전 선택 시 주의하세요.

4-3. 긴급 수정(핫픽스)

• 앱 실행에 심각한 오류가 발생한 경우, 채널톡으로 즉시 문의해 주세요.
• 긴급 상황에서는 신속히 대응합니다.

4-4. 출시 후 모니터링

출시 직후에는 예상치 못한 오류나 성능 이슈가 발생할 수 있어요.
아래 항목을 중심으로 출시 후 모니터링을 권장해요.

• 주요 오류 로그 및 크래시 로그
• Sentry 설정하기를 통한 Sentry 모니터링
• API 응답 지연/실패율
• 사용자 피드백 및 사용성 문제
  • 내비게이션 바의 ‘신고하기’ 기능을 통해 사용자 의견을 받을 수 있어요.
  • 접수된 피드백은 콘솔의 '신고 내역' 메뉴에서 확인할 수 있어요.
• 외부 리소스/CDN 로딩 지연 또는 실패 이슈