Skip to content

비게임 출시 가이드

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

💡 확인해 주세요

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

1. 접속 (브릿지 뷰)

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

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


  • 토스 로그인을 사용할 때는 사용자가 서비스의 성격과 가치를 이해할 수 있도록 인트로 화면을 제공해야 하며, 서비스 소개 없이 곧바로 로그인을 유도하는 것은 허용되지 않아요.


  • 브릿지 뷰 이후 과도한 로딩(20초 이상)이 되는 것은 아닌지 확인해 주세요.

2. 시스템 모드

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

3. 확대/축소

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

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

4. 내비게이션 바

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

  • 네비게이션을 구성하는 요소의 크기, 색상, 위치는 커스텀을 할 수 없어요.
  • 내비게이션의 앱 로고가 일관되게 적용되도록 콘솔에서 앱 등록하기를 참고해 주세요.


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

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

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

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

6. 앱 내 기능

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

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

7. 토스페이

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

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

8. 인앱결제

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

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

9. 프로모션

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

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

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

10. 기능성 메시지 발송

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

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

11. 인앱광고

앱인토스 콘솔에서 인앱광고를 설정하여 연동한 경우 아래 내용을 확인해 주세요.

  • 콘솔에서 설정한 광고는 반드시 정상 노출되어야 해요.
  • 광고는 사전 로드되어야 해요.
  • 광고 종료 후 음악을 사용하는 경우 음악이 재개되어야 해요.
  • 광고 종료/중도 종료 시 정상적으로 미니앱으로 다시 랜딩 되어야 해요.
  • (리워드 광고의 경우) 광고 완료 후에만 보상이 지급되어야 해요.

12. 앱 사용 권한

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

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

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

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

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

14. 보안

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