자주 묻는 질문
확인해 주세요
자주 묻는 질문의 내용은 운영 정책 개편과 콘솔 기능 업데이트 등의 사유로 변경될 수 있어요.
자주 묻는 질문에 없는 개발 문의는 개발자 커뮤니티, 운영 문의는 채널톡으로 문의해 주세요.
앱인토스 서비스
앱인토스는 파트너사가 개발한 미니앱 서비스를 토스 앱 안에서 ‘앱인앱(App-in-App)’ 형태로 출시할 수 있는 플랫폼이에요.
WebView 또는 React Native 기반 SDK와 토스 디자인 시스템을 통해 손쉽게 개발할 수 있고, 푸시·알림과 프로모션 등을 활용해 효과적인 마케팅도 진행할 수 있어요.
토스의 SDK와 API, UI 컴포넌트 등을 통해 로그인, 결제, 인증 등 핵심 기능을 빠르게 적용할 수 있어요.
개발 환경, 디자인, 마케팅, 수익화, 정산까지 통합 솔루션을 제공해요.
앱인토스는 토스 플랫폼 정책, 관련 법령, 사용자 보호 기준에 따라 오픈이 제한되는 서비스가 있어요.
관련 내용은 서비스 오픈 정책 에서 확인할 수 있어요.
게임 서비스는 약 2~4주, 비게임 서비스는 약 1~3개월 정도 소요돼요.
서비스 유형과 기능 범위, 검수 과정에 따라 일정은 달라질 수 있어요.
앱인토스 미니앱 서비스는 만 19세 이상의 사용자를 대상으로 제공돼요.
Android 7 이상 또는 iOS 16 이상 환경에서 이용할 수 있어요.
앱인토스 웨비나 자료는 앱인토스 콘솔과 비즈니스 어드민 아카데미 에서 확인이 가능해요.
앱 등록
게임 서비스인지, 비게임 서비스인지에 따라 작성하는 정보가 달라요.
주로 서비스 기획의 내용을 작성해요.
- 게임: 앱 로고, 앱 이름, appName, 고객문의 이메일, 카테고리, 등급 정보, 앱 검색 키워드, 게임 앱 설명, 썸네일, 리더보드 등
- 비게임: 앱 로고, 앱 이름, appName, 고객문의 이메일, 카테고리, 앱 설명, 앱 검색 키워드 등
검토 완료까지 영업일 기준 1~2일 소요돼요.
appName은 앱 ID와 같은 개념이에요.
앱 ID는 앱 정보에서 등록하고 수정 및 삭제가 불가능해요.
게임 미니앱을 출시하기 위해서는 ‘게임 등급분류’가 필요해요.
게임산업진흥에 관한 법률에 따르면, 게임을 유통하거나 서비스할 목적으로 제작∙배급하려면 반드시 등급분류를 받아야 해요.
법적으로 정식 출시 전에 등급을 받지 않은 게임은 서비스를 출시할 수 없어요.
등급 정보를 등록하기 위해서는 스토어 링크 혹은 게임물관리위원회의 서류가 필요해요.
스토어와 게임물관리위원회에서 등급 분류를 받는 방법은 앱인토스 공식 홈페이지의 블로그 에서 확인할 수 있어요.
검토 완료까지 영업일 기준 1일 소요돼요.
사업자가 없어도 앱을 출시할 수 있어요.
다만, 사업자가 없으면 계약 및 정산 등을 위해 일부 기능을 사용하지 못해요.
- 사업자가 필요한 기능: 토스 로그인, 비즈월렛, 프로모션, 인앱 광고, 토스페이, 인앱 결제
디자인
고객의 예상을 벗어난 설계를 한 다크패턴 디자인의 미니앱은 출시할 수 없어요.
대표적인 다크패턴의 예시는 아래와 같아요.
- 서비스에 진입하자마자 바텀싯이 뜨는 경우
- Back 버튼을 눌렀을 때, 이전 화면을 맏는 바텀싯이 뜨는 경우
- 나갈 수 있는 기능이 없는 경우
- 예상치 못한 순간에 광고가 뜨는 경우
- CTA 버튼을 보고 자신이 해야할 행동을 예상할 수 없는 경우
자세한 내용은 개발자센터 디자인 파트 내 다크패턴 방지 정책 가이드 를 참고해 주세요.
TDS는 Toss Design System의 약자이며, 토스 커뮤니티에서 사용하는 디자인 시스템이에요.
TDS는 토스 제품을 구성하며 직군을 초월한 협업을 가능케하는 디자인 언어이면서 개발자의 도구이기도 해요.
TDS를 사용하면 사용자에게 일관된 제품 경험을 제공하면서 디자이너가 문제 해결에만 집중할 수 잇어요.
개발도 커스텀 UI 보다 3~5배 빠르게 완료할 수 있어요.
관련 내용은 개발자센터의 디자인 파트 내 토스 디자인 시스템 가이드 를 참고해 주세요.
앱인토스 SDK와의 의존성을 위해 필수로 설치해야 해요.
TDS를 안전하고 올바르게 사용하기 위해 아래와 같은 내용을 주의해 주세요.
- 지식재산권: 토스가 앱인토스 서비스를 통하여 제공하는 모든 자료의 권리는 토스에 귀속됩니다. 파트너사는 해당 자료를 오직 앱인토스 서비스 이용을 위한 범위 내에서만 사용할 수 있어요.
- 사용 권한: 토스의 TDS 사용 허가는 앱인토스 서비스 제공을 위한 제한적 사용권을 부여하는 것입니다. 따라서 파트너사는 이 범위를 넘어서는 결과물이나 권리를 취득할 수 없습니다.
- 준수 의무 및 위반 시 조치: 파트너사는 본 조항 및 관련 법령을 준수해야 합니다. 파트너사가 이를 위반할 경우, 토스는 앱인토스 서비스 제공을 중단하거나 기타 필요한 조치를 취할 수 있습니다.
앱빌더는 앱인토스 파트너사를 위한 UI 디자인 툴이에요.
별다른 설치 없이 토스의 UI 스타일 가이드를 따른 화면을 빠르게 완성할 수 있어요.
관련 내용은 개발자센터의 디자인 파트 내 앱빌더 가이드 를 참고해 주세요.
현재 앱인토스 미니앱에서는 다크 모드를 지원하지 않아요.
라이트 모드 기준으로 개발/디자인 및 출시해야 해요.
개발자센터의 디자인 파트 내 피그마 가이드 에서 확인할 수 있어요.
모든 컴포넌트를 반드시 TDS로 디자인해야 하는 것은 아니에요.
다만, 일관된 사용자 경험을 위해 가능한 한 TDS 사용을 권장하며, TDS로 해결이 어려운 영역은 자체 개발해 주세요.
Toss Products Sans 폰트는 별도로 제공하지 않아요.
토스 프로덕트 산스체를 적용하려면 TDS 컴포넌트를 이용해주세요.
개발
기존 서비스를 앱인토스 환경에 맞게 클라이언트 측을 개발한 뒤, 필요에 따라 자체 백엔드 서버와 연동할 수 있어요.
자세한 내용은 가이드 를 참고해주세요.
아니요. 앱인토스 SDK를 설치하면 기본 네비게이션 바가 자동으로 적용돼요.
API 서버의 CORS 허용 목록에 앱인토스 도메인을 추가해야 해요.
설정 방법은 가이드 를 참고해주세요
네. 앱인토스 API의 서버간 통신에는 mTLS 인증을 필수로 요구해요.
적용하지 않으면 ERR_NETWORK 오류가 발생할 수 있어요.
Sentry를 연동해 클라이언트 로그를 확인하면 디버깅할 수 있어요.
안드로이드 샌드박스 앱 연결을 위해 adb 설정이 필요해요.
자세한 내용은 가이드 를 참고해주세요.
가능해요. 유니티 포팅 가이드 를 참고해 미니앱 환경에 맞게 포팅해주세요.
가이드
에 맞게 .ait 파일을 다시 빌드해주세요.
빌드 과정에서 deploymentId가 올바르게 포함되어야 해요.
네. WebView 환경에서 일반적인 웹 API 사용은 제한하지 않아요.
앱이 삭제되면 Storage에 저장된 데이터도 함께 삭제돼요.
앱 삭제나 기기 변경 후에도 데이터를 유지해야 한다면 자체 서버와 연동해 주세요.
출시 검수
앱 출시 검수는 서비스, 기능, 디자인, 보안을 검토해요.
- 서비스: 앱인토스 미니앱으로 출시가 가능한 서비스인지 확인해요.
- 기능: 사용자가 서비스를 정상적으로 이용할 수 있도록 기능이 동작하는지 확인해요.
- 디자인: 출시 가이드에 따른 정책을 위반하지 않았는지 확인해요.
- 보안: 앱인토스 보안에 부정적인 영향을 미치는지 확인해요.
검토 완료까지 영업일 기준 3일 소요돼요.
앱 번들은 압축 해제 기준 100MB 이하만 업로드할 수 있어요.
현재 앱 출시 검토 요청은 1개의 번들(버전)만 진행할 수 있어요.
오류가 있는 번들의 검토 요청을 취소하고, 재업로드 후에 다시 검토 요청을 하면 돼요.
앱 출시 검수에서 반려되면 반려사유를 통해 어떤 점을 개선해야 하는지 확인할 수 있어요.
반려사유 기반으로 개선한 후, 다시 검토 요청을 하면 돼요.
반려사유는 콘솔 우측 하단의 채널톡의 상담원 연결을 통해 문의할 수 있어요.
마케팅
콘솔의 마케팅 도구로서 푸시, 알림은 토스의 앱 자체에서 발송이 이루어지기 때문에, 토스 라이팅 규칙을 지켜야 해요.
관련 가이드는 콘솔 가이드에서 참고해 주세요.
광고성 메시지와 기능성 메시지는 목적이 다르며, 활용 방법도 달라요.
- 광고성 메시지: 할인, 이벤트, 신규 상품 안내처럼 마케팅 목적의 프로모션 메시지를 의미해요. 설정한 세그먼트에게 광고성 메시지를 발송할 수 있어요.
- 기능성 메시지: 서비스 이용 과정에서 발생하는 주문, 결제, 배송 등 필수 정보를 전달하는 메시지를 의미해요. API를 통해서 기능성 메시지를 발송할 수 있어요.
더욱 자세한 가이드는 푸시, 알림의 콘솔 가이드 를 참고해 주세요.
워크스페이스 기준으로 하루에 광고 푸시를 10만 명에게 발송할 수 있어요.
검토 완료까지 영업일 기준 2~3일 소요돼요.
토스 > 혜택탭 > 새로운 서비스 써보고에 리스트 형태로 노출돼요.
프로모션의 이해하기 가이드 를 참고해 주세요.
프로모션 지급 테스트를 진행해야 ‘시작하기’를 진행할 수 있어요.
TEST_{promotionCode}로 테스트를 완료해야 해요.
중복 지급 차단 로직은 직접 구현해야 해요.
관련 내용은 프로모션의 개발하기 가이드 를 참고해 주세요.
대시보드의 데이터는 익일 오전 8시 정도에 업데이트 돼요.
수익화
현재 전면형 광고와 보상형 광고를 지원하고 있어요.
- 전면형 광고: 광고가 전체화면으로 표시되며, 화면 전환 지점에서 보여줘요.
- 보상형 광고: ‘광고를 시청하면 보상 지급’의 구조로, 사용자가 원할 때 광고를 볼 수 있어요.
추후 다양한 광고 유형을 지원할 예정이에요.
인앱 광고 테스트를 위해서는 반드시 테스트용 ID를 사용해야 해요.
테스트용 ID는 인앱 광고의 개발하기 가이드 에서 참고해 주세요.
서류 제출 후, 영업일 기준 7~14일 소요돼요.
테스트 Key로는 결제 생성까지만 활용할 수 있어요.
승인 처리는 불가해요.
인앱 결제 상품의 가격은 최소 400원, 최대 1,400,000원까지 설정할 수 있어요.
앱마켓에 따라 환불 처리 방식이 달라요.
- Google Play: 48시간 이내 자동 처리돼요. 이후 수동 요청이 가능해요.
- App Store: 모든 환불은 Apple이 직접 처리해요.
정산
비즈월렛은 광고 푸시 및 프로모션 집행을 위한 선충전 금액이에요.
- 콘솔 > 워크스페이스 > 비즈월렛에서 확인할 수 있어요.
- 충전, 사용, 환급 내역은 실시간으로 업데이트 돼요.
- 인보이스는 익월 1~2일 이내 업데이트가 완료돼요.
- 환급은 캠페인 종료 후 1~2일 이내 자동 반영돼요.
광고 푸시는 아래와 같은 방식으로 과금돼요.
- 등록 시점: 예상 발송 건수 기준 1차 차감
- 실제 발송 후:성공 건수 기준으로 재계산 및 차액 환급
세금계산서는 실방송 기준으로 매월 영업일 3일 이내 발행돼요.
정산을 받기 위해 콘솔 > 워크스페이스 > 파트너 정보 > 정산 정보에 다음 항목을 등록해야 해요.
- 사업자 정보
- 거래 계좌 사본
- 세금계산서 발행용 이메일
모든 정산은 앱 단위가 아니라 사업자 단위로 합산되어 진행돼요.
인앱 광고느 외부 미디에이션 플랫폼 또는 Toss Ads를 통해 송출되며, 광고 수익에서 앱인토스 수수료 15%가 공제된 금액이 파트너사에게 지급돼요. (CBT 기간: 토스 수수료 0%)
관련 내용은 정산의 이해하기 가이드 를 참고해 주세요.
인앱 결제는 앱마켓(애플, 구글)과 앱인토스 각각 수수료가 발생해요.
- 앱마켓 수수료: 공급가 기준 15% 또는 30%
- 토스 수수료: 결제가 기준 5% (CBT 0%)
- 지급일: 익월 말 (영업일 기준)
- 정산내역 제공: 익월 5일 이내
관련 내용은 정산의 이해하기 가이드 를 참고해 주세요.
정산 항목에 따라 발행 주체가 달라요.
-
광고 수익 (파트너사 → 토스 발행)
- 파트너사가 직접 발행
- 발행일자: 수익 발생월의 말일
- 이메일: yj.jang@toss.im
- 기한: 매월 영업일 2일 이내
-
앱인토스 광고 수수료 (토스 → 파트너사 발행)
- 토스가 선공제 후 발행
- 발행일: 매월 영업일 3일 이내
-
인앱 결제 수수료
- 애플 수수료: 토스가 대신 발행
- 토스 수수료: 토스가 발행
구글 기프트카드 결제는 현금영수증 의무가 있어요.
- 2025.12.01 이후 토스에서 자동 대행 발행해요.
- 결제내역에서 기프트카드 여부 확인이 가능해요.
- 앱마켓 직권취소로 정산에서 제외되어도, 현금영수증을 취소하지 말아야 해요.
- 익월 초 제공되는 정산 리포트를 참고해서 처리해 주세요.
홍보
토스 로고는 보도자료 가이드와 외부 광고 가이드에 따라, 색상과 비율을 변경하지 않고 사용해야 해요.
보도자료에서는 ‘입점’이 아닌, ‘토스 제휴’로 표기해야 해요.
그리고 채널톡 문의를 통해 사전 검토 요청 후 승인을 받고 배포해야 해요.