앱인토스 미니앱 출시 검수 체크리스트, 비게임 앱이 자주 놓치는 항목

검수 기준은 비게임 출시 가이드입니다

앱인토스 미니앱의 출시 검수는 서비스, 기능, 디자인, 보안을 봅니다. 비게임 미니앱이라면 개발자센터의 비게임 출시 가이드가 그 기준입니다. 체크리스트를 지키지 않았거나 다크패턴이 보이면 승인되지 않고, 출시 뒤에 발견되어도 노출이 제한되거나 중단될 수 있습니다.

아래 목록은 그 가이드에서 자주 놓치는 항목을 골라 묶은 것입니다. 제출 전에 직접 확인하는 용도이고, 최종 판단은 검수에서 내려집니다. 콘솔 가입부터 출시까지의 전체 순서는 앱인토스 미니앱 개발 가이드에 따로 정리했습니다.

화면마다 사용자가 나가는 길이 분명한지 봅니다.

샌드박스에서 잘 되던 미니앱이 검수에서 막히는 원인이 주로 여기 있습니다.

SSR은 쓸 수 없습니다. CSR이나 SSG로 빌드합니다.
API 통신은 HTTPS, WebSocket은 wss://만 씁니다.
토스 도메인 밖의 자사 사이트로 이동하거나 그 화면을 불러와 보여 주지 않습니다. window.location.replace나 자사 도메인을 띄우는 WebView·iframe이 여기에 해당합니다.
eval처럼 외부에서 받은 코드를 실행하지 않습니다.
앱 브릿지(SDK API)를 짧은 시간에 몰아서 부르지 않고, 실패하면 재시도 횟수와 간격을 제한합니다.
라이트 모드로 구현하고, 지도처럼 꼭 필요한 경우가 아니면 핀치 줌을 끕니다.
스크롤, 터치, 화면 전환 반응이 2초 넘게 늦지 않습니다.
공유 링크에는 테스트용 intoss-private://가 아니라 intoss://를 씁니다.

사용자가 예상하지 못한 화면이나 행동을 강요하지 않는지 봅니다.

들어오자마자 토스 로그인이나 알림 동의 바텀시트가 자동으로 뜨지 않습니다. 화면을 옮길 때 바텀시트로 행동을 강요하지도 않습니다.
토스 로그인을 쓴다면 인트로 화면에서 어떤 서비스인지 먼저 설명합니다.
위치, 알림 같은 기기 권한은 동의를 먼저 받고, 거부해도 나머지 기능은 동작합니다.
CTA 버튼만 보고 다음에 무슨 일이 일어날지 알 수 있습니다.
링크나 버튼으로 자사 서비스 이동이나 자사 앱 설치를 유도하지 않습니다. 서비스에 꼭 필요한 외부 링크는 정상적으로 열립니다.
로그인은 토스 로그인만 제공합니다. 토스 앱에서 연결을 끊으면 미니앱에 사용자 데이터가 남지 않고, 다시 들어오면 약관 화면이 나옵니다.
결제를 붙였다면 주문 금액과 결제창 금액이 같고, 취소하면 주문 화면으로 돌아가며, 실패하면 사유가 보입니다. 토스페이를 쓰는 미니앱은 다른 결제 수단을 함께 두지 않습니다.
광고는 사용자가 예상하지 못한 순간에 전면으로 띄우지 않고, 클릭을 오인하게 만들지 않습니다.

콘솔의 앱 출시 메뉴에서 등록하기를 누르고, 번들을 올린 뒤 나머지 앱 정보를 함께 입력해 검토를 요청합니다.

빌드한 앱 번들(.ait)을 올립니다. 압축을 푼 크기가 100MB 이하여야 합니다.
콘솔의 토스앱 테스트 QR 코드로 토스 앱에서 열어 봅니다. 테스트를 한 번 이상 마쳐야 검토를 요청할 수 있습니다.
부제, 상세 설명, 카테고리, 로고, 주요 기능 같은 앱 정보를 채웁니다. 주요 기능에 넣은 intoss:// 주소가 열리지 않으면 반려될 수 있습니다.
검토를 요청합니다. 결과는 콘솔과 이메일로 안내됩니다.
승인되면 버전 내역의 출시하기 버튼을 눌러야 실제로 출시됩니다.

검토 요청은 한 번에 번들 하나만 진행됩니다. 요청한 뒤 오류를 찾았다면 요청을 취소하고 번들을 다시 올린 다음 새로 요청합니다.

반려되면 콘솔에 사유가 표시됩니다. 사유에 맞춰 고친 뒤 출시 관리에서 재검수를 요청하고, 사유가 이해되지 않으면 콘솔의 채널톡으로 묻습니다. 진행 상태는 출시 관리에서 접수, 검수 중, 승인, 반려로 확인합니다.