비게임 출시 가이드

비게임 미니앱 출시 전에 꼭 확인해야 할 체크리스트를 정리했어요.
아래 내용을 지키지 않으면 앱 출시 검토에서 반려될 수 있으니 반드시 확인해주세요.

확인해 주세요

• 앱 출시 검토 전에는 앱 정보 검토, 사업자 인증, 대표관리자 신청 승인이 먼저 완료되어야 해요.
  • 콘솔에서 앱 등록하기를 확인해 주세요.
• 다크패턴 방지 정책 및 미니앱 브랜딩 가이드을 꼭 준수해 주세요.
• 미니앱에서 제공하는 모든 내용에는 불법성·선정성 등 위법 콘텐츠가 없어야 해요.
• 자사 앱 및 자사 웹으로의 유도는 불가하므로 가이드를 꼭 준수해 주세요.

1. 접속 (브릿지 뷰)

토스 앱 내에서 미니앱 서비스를 선택했을 때 유저가 처음으로 만나게 되는 화면이에요.

• 앱 진입 시 앱 이름, 앱 로고, 대표 색상을 보여주는 브릿지 뷰가 정상적으로 적용되는지 확인해야 해요.
• 미니앱 접속 화면의 분위기와 밝기에 따라 Basic, Inverted를 선택할 수 있어요.

• 토스 로그인을 사용하는 경우, 사용자가 서비스의 성격과 가치를 이해한 상태에서 로그인(약관 동의)을 진행할 수 있어야 해요.
• 특히 미니앱 진입과 함께 토스 로그인을 요청하려면, 첫 화면에서 인트로 페이지를 통해 어떤 서비스인지 명확히 안내해야 해요.

2. 시스템 모드

현재 앱인토스 미니앱 서비스는 다크모드를 제공하지 않아요.
따라서 미니앱 내 테마는 라이트 모드 기준으로 설정해야 하고, 내비게이션 바 또한 라이트 모드로 고정되어야 해요. 추후 다크모드가 제공되면 공지해 드릴 예정이에요.

3. 확대/축소

미니앱의 화면을 손가락으로 확대 또는 축소하는 액션을 할 때에 관한 내용이에요.

• 미니앱 내에서 제스처를 통한 확대/축소 기능은 기본적으로 사용이 불가해요.
  • 사용자의 미니앱 경험을 수호하기 위함이에요.
  • 단, 지도 서비스를 제공하는 등 기능적으로 꼭 필요한 경우에만 제한적으로 이용할 수 있어요.

핀치줌 막기

meta viewport에 initial-scale=1, maximum-scale=1, user-scalable=no 를 추가하면 모바일에서 핀치줌을 비활성화할 수 있어요.

4. 내비게이션 바

미니앱 상단에 위치하는 공통으로 적용되는 내비게이션 바를 말해요.

• 네비게이션을 구성하는 요소의 크기, 색상, 위치는 커스텀을 할 수 없어요.
• 내비게이션의 앱 로고가 일관되게 적용되도록 콘솔에서 앱 등록하기를 참고해 주세요.
• 홈 버튼과 제휴사 기능 버튼 추가하는 방법은 내비게이션 바 설정 문서를 참고하세요.

위치	항목	설명
좌측	뒤로가기 버튼 (<)	선택 - 히스토리백이 필요한 경우 사용해요. - 자체 UI 내에서 히스토리백을 수행할 수 있는 경우 사용하지 않아요. - 진입 시 첫 화면에서는 백버튼을 사용하지 않아요.
	브랜드 로고 + 이름	필수
	홈 버튼	선택 - 미니앱 서비스의 홈으로 가는 진입점이 필요한 경우 사용해요.
우측	제휴사 기능 버튼	선택 - 화면에 필요한 기능 1개를 노출시킬 수 있어요. - 모노 아이콘만 추가할 수 있어요. - 문구나 커스텀 UI는 지원하지 않아요. - 화면별로 커스텀이 가능해요. - 홈 버튼은 넣을 수 없어요.
	더보기 버튼 (⋯)	필수 - 신고하기, 공유하기 등 토스의 기능이 들어가요. - 커스텀할 수 없어요.
	닫기 버튼 (X)	필수

5. 전반적인 서비스 이용 및 동작

원활한 사용자 경험을 위한 미니앱의 전반적인 이용 및 동작에 대한 내용이에요.

• 앱 정보의 나이 제한과 실제 서비스 내용이 일치해야 해요.
• 스크롤/인터랙션 반응은 2초 이상 지연되면 안 돼요.
  • 2초 이상이 될 경우 사용자가 이탈할 가능성이 높아져요.
• 재접속 시 데이터가 유지되어야 해요. (작성 중인 내용, 마이페이지 등)
• 모든 컴포넌트가 정상적으로 작동해야 해요.
  • 사용자가 접속할 수 없는 버튼이나 미니앱에서는 할 수 없지만 자사 앱/웹에는 기능을 제공한다는 등의 안내가 되는 컴포넌트는 사용할 수 없어요.
• 리스트 정렬·검색·필터링 기능이 정상 작동해야 해요.
  • 리스트 정렬은 ‘최근순 / 가격순’과 같은 기능을 제공하는 경우를 말해요.
• 기능화 되지 않은 컴포넌트는 포함하면 안 돼요.
  • 사용자가 접속할 수 없는 버튼이나 미니앱에서는 할 수 없지만 자사 앱/웹에는 기능을 제공한다는 등의 안내가 되는 컴포넌트는 사용할 수 없어요.
• 특정 연령층, 혹은 특정 그룹만 이해할 수 있는 유행어, 밈 등은 사용할 수 없어요.
  • UX 라이팅 가이드에서도 확인할 수 있어요.

6. 접근성

앱인토스는 토스 앱의 서비스로서, 모든 사용자가 불편 없이 미니앱을 이용할 수 있도록 접근성 준수를 권장하고 있어요.

• 텍스트·버튼 등 주요 요소의 명도 대비(contrast) 가 충분한지 확인해 주세요.
• 버튼, 조작 UI는 터치 영역을 확보해 주세요.
• 화면 전환, 애니메이션 등이 지나치게 빠르거나 현기증을 유발하지 않도록 구현해 주세요.
• 스크린 리더 사용 시 주요 콘텐츠가 의도한 순서대로 읽히는지 확인해 주세요.
• 접근성에 대한 더 자세한 사항은 가이드를 참고해 주세요.

7. 앱 내 기능

앱 내 기능은 앱 출시하기를 통해 등록하는 것으로 사용자가 특정 기능에 바로 접속할 수 있게 제공하는 진입점이에요.

• 앱 내 기능으로 제공되는 모든 기능은 미니앱에서 모두 정상 동작해야 해요.
  • 예) “청소용품 알아보기” 라는 기능을 제공할 때, 해당 기능으로 접속 시 청소용품이 아닌 다른 상품으로 접속이 되면 안돼요.
• 기능별 앱 스킴 접속이 원활해야 하고, 뒤로가기도 정상 동작해야 해요.
  • 앱 내 기능은 특정 기능(메뉴)에 접속하게 되므로 뒤로가기를 누를 미니앱 메인화면으로 랜딩 되어야 해요.

8. 토스 로그인

토스 로그인을 사용한 경우에 아래 내용을 모두 확인해 주세요.

• 콘솔에서 등록한 약관 및 약관 확인 시 정상적으로 연결하는지 확인해 주세요.
• 약관 확인 및 체크 박스 선택과 하단의 ‘동의하고 시작하기’ CTA를 누를 경우 정상적으로 로그인이 진행되는지 확인해 주세요.
  • 로그인 실패로 노출이 되거나 로그인이 완료되었다면 다른 페이지로 이동 시 로그인이 풀리지 않아야 해요.
  • ‘동의하고 시작하기’를 하지 않고 ‘닫기’ 버튼을 눌러서 로그인 화면을 이탈하면 미니앱의 메인으로 복귀해야 해요.
• 토스앱 설정에서 ‘토스로 로그인한 서비스’ 에서 로그인을 끊으면 다시 미니앱 접속 시 기존 데이터가 남아 있지 않고 새롭게 로그인을 요청하는지 확인해 주세요.
• 토스 로그인 요청 화면에서 ‘닫기’ 를 누를 경우 아래와 같이 작동하게 해주세요.
  • 로그인을 인트로 페이지에서 약관을 받는 경우 닫기 버튼을 눌렀을 때 → 미니앱이 닫힘
  • 서비스 플로우 중간에 약관을 받는 경우 → 이전 미니앱 화면으로 랜딩
• 토스 로그인이 아닌 자사 로그인 및 기타 간편 로그인의 경우 사용이 불가해요.

9. 토스페이

미니앱에서 결제 기능을 제공할 때 사용하는 토스페이 간편결제 연동에 관한 내용이에요.

• 미니앱 내에서 결제 기능이 필요한 경우 토스페이만 사용할 수 있어요.
  • 토스페이 외에 다른 결제 수단은 사용할 수 없어요.
• 주문 요청 금액과 결제창 금액이 일치해야 해요.
• 결제·취소가 정상 처리되어야 해요.
  • 토스페이 화면에서 결제가 정상적으로 진행되었을 때, 미니앱에서도 정상적으로 결제 진행이 완료되어야 해요.
  • 사용자가 결제 도중 취소를 하는 경우 미니앱 주문 화면으로 랜딩 되어야 해요.
• 결제 실패 시 오류 메시지를 안내해야 해요.
• 결제 내역은 미니앱에서도 확인할 수 있어야 해요.

10. 인앱결제

디지털 상품을 판매하는 경우 인앱결제를 연동하고, 연동 후에는 아래 내용을 꼭 확인해 주세요.

• 미니앱 내에서 표기된 상품의 금액과 실제 결제가 진행되는 애플 또는 구글플레이스토어 결제창의 금액이 일치하는지 확인해 주세요.
• 결제 진행 시 오류 없이 결제가 진행되고, 결제를 완료하지 않고 이탈하면 정상적으로 취소 처리가 되는지 확인해 주세요.
• 현재 구독 상품은 제공할 수 없어요.
• 오류 등으로 인해 결제가 실패되었다면 어떤 오류로 결제가 실패되었는지 사용자에게 안내해 주세요.
• 결제한 내역을 사용자가 확인할 수 있게 내역이 제공되는지 확인해 주세요.
• 사용자가 기기를 변경한 후에도 인앱결제를 통해 결제한 데이터가 유지되는지 확인해 주세요.

11. 프로모션

프로모션을 사용하는 경우에는 프로모션 검토 가이드를 꼭 확인해 주세요.

또한 자체적인 이벤트나 프로모션인 경우에도 프로모션 가이드 및 아래 내용은 진행할 수 없어요.

• 현금성 또는 환금성 이벤트
• 아이템, 기프티콘, 상품권 등을 현금화하거나 포인트를 토스포인트로 전환하는 이벤트
• 사행성 또는 투기성 등 성격의 이벤트

12. 기능성 메시지 발송

기능성 메시지는 ‘서비스 이용에 꼭 필요한 필수 알람’을 뜻해요.

결제 완료, 배송 중, 배송 완료 등 사용자가 꼭 받아야 하는 알림만 발송할 수 있어요.

• 콘솔에서 설정한 템플릿 형태로 푸시/알람이 정상 발송되어야 해요.
• 푸시/알림 가이드와 UX 라이팅 가이드를 꼭 확인해 주세요.

13. 인앱광고

앱인토스 콘솔에서 인앱 광고를 설정하여 연동한 경우, 아래 항목을 반드시 확인해 주세요.
광고 로딩, 종료, 리워드 처리 등은 모두 검수 항목에 포함돼요.

• 콘솔에서 설정한 광고가 정상적으로 노출되는지 확인해 주세요.
• 광고는 반드시 사전 로드(Preload) 되어야 해요.
  • 페이지 진입 시마다 광고를 사전 로드해 두면 노출 지연을 방지할 수 있어요.
• 리워드 광고의 경우, 광고가 정상적으로 완료된 이후에만 보상이 지급되어야 해요.
  • 광고가 중도 종료되거나 실패한 경우에는 보상이 지급되지 않아야 해요.
• 광고를 표시할 때(show 호출)에는 반드시 광고 SDK에서 전달하는 이벤트(event) 를 받아 처리해야 해요.
  • 이벤트를 수신하지 않은 상태에서 내부 처리를 진행하면 오류가 발생하거나 eCPM(노출 단가)에 영향을 줄 수 있어요.
• 광고 종료 후에는 미니앱의 음악이 자동으로 재개되어야 해요.
• 광고가 정상 종료되거나 중도 종료될 경우, 사용자 화면이 정상적으로 미니앱으로 복귀(랜딩) 되어야 해요.
• 출시 전에는 테스트용 광고 ID가 설정되어 있지 않은지 반드시 확인해 주세요.

14. 앱 사용 권한

개발한 미니앱에서 사용되는 권한들에 대한 내용이에요.

• 콘솔에서 앱 번들을 업로드하면 미니앱에서 필요한 권한들을 확인할 수 있어요.
• 사용이 필요한 권한이 정상적으로 적용 및 작동되고 있는지 꼭 확인해주세요.
• 사용자가 특정 권한 동의를 하지 않더라도 해당 기능을 제외한 나머지 기능이 정상적으로 작동되어야 해요.

15. 데이터 및 메모리 사용량

미니앱을 이용하면서 발생 되는 데이터 사용량과 메모리 사용량에 대한 내용이에요.

• 데이터 사용량이 과도하면 사용자의 불편과 부정적인 CS로 이어질 수 있어요.
• 메모리 누수가 발생할 경우 휴대폰 발열로 이어지며 사용자로 하여금 부정적인 경험을 제공하게 돼요.
• 앱인토스 검수 과정에서도 데이터 사용량과 메모리 사용량을 체크하니, 과도한 데이터 사용과 메모리 누수가 발생하지 않도록 꼭 확인해 주세요.

16. 보안

보안 이슈가 발생하는 경우에는 앱 출시 검토에서 반려될 수 있어요.
반려된 경우, 자세한 사유는 이메일과 콘솔에서 확인할 수 있어요.