> For the complete documentation index, see [llms.txt](https://developers-apps-in-toss.toss.im/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers-apps-in-toss.toss.im/guide/faq.md).
# 자주 묻는 질문
{% hint style="info" %}
**확인해 주세요**
자주 묻는 질문의 내용은 운영 정책 개편과 콘솔 기능 업데이트 등의 사유로 변경될 수 있어요. 자주 묻는 질문에 없는 개발 문의는 [개발자 커뮤니티](https://techchat-apps-in-toss.toss.im/), 운영 문의는 [채널톡](https://apps-in-toss.channel.io/workflows/787658)으로 문의해 주세요.
{% endhint %}
### 앱인토스 서비스
앱인토스는 어떤 서비스인가요?
앱인토스는 파트너사가 개발한 미니앱 서비스를 토스 앱 안에서 '앱인앱(App-in-App)' 형태로 출시할 수 있는 플랫폼이에요.
WebView 또는 React Native 기반 SDK와 토스 디자인 시스템을 통해 손쉽게 개발할 수 있고, 푸시·알림과 프로모션 등을 활용해 효과적인 마케팅도 진행할 수 있어요.
자세한 내용은 앱인토스란 가이드를 참고해 주세요.
앱인토스에서 어떤 기능을 제공하나요?
토스의 SDK와 API, UI 컴포넌트 등을 통해 로그인, 결제, 인증 등 핵심 기능을 빠르게 적용할 수 있어요.
개발 환경, 디자인, 마케팅, 수익화, 정산까지 통합 솔루션을 제공해요.
자세한 내용은 앱인토스란 가이드를 참고해 주세요.
앱인토스 미니앱으로 오픈할 수 없는 서비스가 있나요?
앱인토스는 토스 플랫폼 정책, 관련 법령, 사용자 보호 기준에 따라 오픈이 제한되는 서비스가 있어요.
관련 내용은 [서비스 오픈 정책](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/intro/guide)에서 확인할 수 있어요.
앱인토스 미니앱 개발부터 출시까지 얼마나 걸리나요?
게임 서비스는 약 2\~4주, 비게임 서비스는 약 1\~3개월 정도 소요돼요.
서비스 유형과 기능 범위, 검수 과정에 따라 일정은 달라질 수 있어요.
자세한 내용은 서비스 오픈 프로세스 가이드를 참고해 주세요.
앱인토스 미니앱 서비스를 이용할 수 있는 사용자는 누구인가요?
앱인토스 미니앱 서비스는 만 19세 이상의 사용자를 대상으로 제공돼요.
Android 7 이상 또는 iOS 16 이상 환경에서 이용할 수 있어요.
앱인토스에 서비스를 등록하고 싶은데 절차가 어떻게 되나요?
콘솔 가입 → 워크스페이스 생성 → 사업자 등록 → 앱 등록 → 검수 요청 순서로 진행돼요.
개발자센터의 시작하기 문서에서 단계별 가이드를 확인할 수 있어요.
앱인토스 웨비나 자료는 어디서 확인할 수 있나요?
앱인토스 웨비나 자료는 앱인토스 콘솔과 [비즈니스 어드민 아카데미](https://business.toss.im/dashboard/business-academy)에서 확인이 가능해요.
### 앱 등록
앱 등록을 위해서는 어떤 정보가 필요한가요?
게임 서비스인지, 비게임 서비스인지에 따라 작성하는 정보가 달라요.
주로 서비스 기획의 내용을 작성해요.
* 게임 : 앱 로고, 앱 이름, appName, 고객문의 이메일, 카테고리, 등급 정보, 앱 검색 키워드, 게임 앱 설명, 썸네일, 리더보드 등
* 비게임: 앱 로고, 앱 이름, appName, 고객문의 이메일, 카테고리, 앱 설명, 앱 검색 키워드 등
자세한 내용은 콘솔에서 앱 등록하기 가이드를 참고해 주세요.
앱 등록 검수는 얼마나 걸리나요?
검토 완료까지 영업일 기준 1\~2일 소요돼요.
자세한 내용은 콘솔에서 앱 등록하기 가이드를 참고해 주세요.
appName을 수정하거나 삭제할 수 없나요?
appName은 앱 ID와 같은 개념이에요.
앱 ID는 앱 정보에서 등록하고 수정 및 삭제가 불가능해요.
자세한 내용은 콘솔에서 앱 등록하기 가이드를 참고해 주세요.
게임 서비스의 등급 심사를 어떻게 받을 수 있나요?
게임 미니앱을 출시하기 위해서는 '게임 등급분류'가 필요해요.
게임산업진흥에 관한 법률에 따르면, 게임을 유통하거나 서비스할 목적으로 제작∙배급하려면 반드시 등급분류를 받아야 해요.법적으로 정식 출시 전에 등급을 받지 않은 게임은 서비스를 출시할 수 없어요.
등급 정보를 등록하기 위해서는 스토어 링크 혹은 게임물관리위원회의 서류가 필요해요.
스토어와 게임물관리위원회에서 등급 분류를 받는 방법은 [앱인토스 공식 홈페이지의 블로그](https://toss.im/apps-in-toss/blog/game_rating_classification)에서 확인할 수 있어요.
게임산업진흥에 관한 법률에 따르면, 게임을 유통하거나 서비스할 목적으로 제작∙배급하려면 반드시 등급분류를 받아야 해요.
법적으로 정식 출시 전에 등급을 받지 않은 게임은 서비스를 출시할 수 없어요.
등급 정보를 등록하기 위해서는 스토어 링크 혹은 게임물관리위원회의 서류가 필요해요. 스토어와 게임물관리위원회에서 등급 분류를 받는 방법은 [앱인토스 공식 홈페이지의 블로그](https://toss.im/apps-in-toss/blog/game_rating_classification) 에서 확인할 수 있어요.
사업자 등록 검수는 얼마나 걸리나요?
검토 완료까지 영업일 기준 1일 소요돼요.
검수 결과는 콘솔에서 확인할 수 있어요.
자세한 내용은 사업자 등록하기 가이드를 참고해 주세요.
사업자등록증을 변경/추가 제출해야 하는데 어떻게 하나요?
콘솔 > 설정 > 사업자 정보에서 사업자등록증을 업로드할 수 있어요.
변경 시 재검토가 필요하며, 영업일 1\~2일 소요돼요.
개인→법인 변경 시 사업자번호가 달라지면 워크스페이스를 새로 만들어야 해요.
자세한 내용은 사업자 등록하기 가이드를 참고해 주세요.
사업자가 없으면 앱을 출시할 수 없나요?
사업자가 없어도 앱을 출시할 수 있어요.
다만, 사업자가 없으면 계약 및 정산 등을 위해 일부 기능을 사용하지 못해요.
사업자가 필요한 기능: 토스 로그인, 비즈월렛, 프로모션, 인앱 광고, 토스페이, 인앱 결제
자세한 내용은 사업자 등록하기 가이드를 참고해 주세요.
### 디자인
앱인토스 미니앱 디자인의 다크패턴 관련 정책이 있나요?
고객의 예상을 벗어난 설계를 한 다크패턴 디자인의 미니앱은 출시할 수 없어요.
대표적인 다크패턴의 예시는 아래와 같아요.
* 서비스에 진입하자마자 바텀싯이 뜨는 경우
* Back 버튼을 눌렀을 때, 이전 화면을 막는 바텀시트가 뜨는 경우
* 나갈 수 있는 기능이 없는 경우
* 예상치 못한 순간에 광고가 뜨는 경우
* CTA 버튼을 보고 자신이 해야할 행동을 예상할 수 없는 경우
자세한 내용은 개발자센터 디자인 파트 내 [다크패턴 방지 정책 가이드](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/design/consumer-ux-guide)를 참고해 주세요.
TDS가 무엇인가요?
TDS는 Toss Design System의 약자이며, 토스 커뮤니티에서 사용하는 디자인 시스템이에요.
TDS는 토스 제품을 구성하며 직군을 초월한 협업을 가능케하는 디자인 언어이면서 개발자의 도구이기도 해요.
TDS를 사용하면 사용자에게 일관된 제품 경험을 제공하면서 디자이너가 문제 해결에만 집중할 수 있어요.
개발도 커스텀 UI 보다 3\~5배 빠르게 완료할 수 있어요.
관련 내용은 [개발자센터의 디자인 파트 내 토스 디자인 시스템 가이드](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/design/components) 를 참고해 주세요.
TDS를 꼭 사용해야 하나요?
앱인토스 SDK와의 의존성을 위해 필수로 설치해야 해요.
자세한 내용은 토스 디자인 시스템 가이드를 참고해 주세요.
TDS를 사용하기 전에 주의할 점이 있나요?
TDS를 안전하고 올바르게 사용하기 위해 아래와 같은 내용을 주의해 주세요.
지식재산권: 토스가 앱인토스 서비스를 통하여 제공하는 모든 자료의 권리는 토스에 귀속돼요. 파트너사는 해당 자료를 오직 앱인토스 서비스 이용을 위한 범위 내에서만 사용할 수 있어요.
사용 권한: 토스의 TDS 사용 허가는 앱인토스 서비스 제공을 위한 제한적 사용권을 부여하는 것이에요. 따라서 파트너사는 이 범위를 넘어서는 결과물이나 권리를 취득할 수 없어요.
준수 의무 및 위반 시 조치: 파트너사는 본 조항 및 관련 법령을 준수해야 해요. 파트너사가 이를 위반할 경우, 토스는 앱인토스 서비스 제공을 중단하거나 기타 필요한 조치를 취할 수 있어요.
자세한 내용은 피그마/TDS UI 라이선스 가이드를 참고해 주세요.
앱빌더가 무엇인가요?
앱빌더는 앱인토스 파트너사를 위한 UI 디자인 툴이에요.
별다른 설치 없이 토스의 UI 스타일 가이드를 따른 화면을 빠르게 완성할 수 있어요.
관련 내용은 [개발자센터의 디자인 파트 내 앱빌더 가이드](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/design/prepare/design) 를 참고해 주세요.
앱인토스 미니앱은 시스템 모드의 다크 모드를 지원하나요?
현재 앱인토스 미니앱에서는 다크 모드를 지원하지 않아요.
라이트 모드 기준으로 개발/디자인 및 출시해야 해요.
피그마 리소스는 어디서 받을 수 있나요?
개발자센터의 디자인 파트 내 피그마 가이드 에서 확인할 수 있어요.
반드시 TDS를 사용해야 하나요?
모든 컴포넌트를 반드시 TDS로 디자인해야 하는 것은 아니에요.
다만, 일관된 사용자 경험을 위해 가능한 한 TDS 사용을 권장하며, TDS로 해결이 어려운 영역은 자체 개발해 주세요.
자세한 내용은 토스 디자인 시스템 가이드를 참고해 주세요.
Toss Products Sans 폰트를 제공해줄 수 있나요?
Toss Products Sans 폰트는 별도로 제공하지 않아요.
토스 프로덕트 산스체를 적용하려면 TDS 컴포넌트를 이용해주세요.
자세한 내용은 토스 디자인 시스템 가이드를 참고해 주세요.
### 개발
현재 운영 중인 서비스가 있어요. 앱인토스 미니앱으로 어떻게 배포하나요?
기존 서비스를 앱인토스 환경에 맞게 클라이언트 측을 개발한 뒤, 필요에 따라 자체 백엔드 서버와 연동할 수 있어요.
자세한 내용은 [가이드](https://appsintoss.gitbook.io/appsintoss-docs/ai-vibe-coding/tutorials/webview) 를 참고해주세요.
내비게이션 바는 직접 구현해야 하나요?
아니요. 앱인토스 SDK를 설치하면 기본 내비게이션 바가 자동으로 적용돼요.
자세한 내용은 UI Config 가이드를 참고해 주세요.
외부 API 호출 시 CORS 에러가 발생해요.
API 서버의 CORS 허용 목록에 앱인토스 도메인을 추가해야 해요.
설정 방법은 [가이드](https://appsintoss.gitbook.io/appsintoss-docs/documentation/common/network-environment/network#%E1%84%90%E1%85%A9%E1%84%89%E1%85%B3%E1%84%8B%E1%85%A2%E1%86%B8%E1%84%8B%E1%85%A6%E1%84%89%E1%85%A5-%E1%84%90%E1%85%A9%E1%86%BC%E1%84%89%E1%85%B5%E1%86%AB%E1%84%8B%E1%85%B5-%E1%84%83%E1%85%AC%E1%84%8C%E1%85%B5-%E1%84%8B%E1%85%A1%E1%86%AD%E1%84%82%E1%85%B3%E1%86%AB-%E1%84%80%E1%85%A7%E1%86%BC%E1%84%8B%E1%85%AE) 를 참고해주세요
mTLS 인증이 꼭 필요한가요?
네. 앱인토스 API의 서버간 통신에는 mTLS 인증을 필수로 요구해요.
적용하지 않으면 `ERR_NETWORK` 오류가 발생할 수 있어요.
자세한 내용은 API 사용하기 가이드를 참고해 주세요.
QR 테스트 중 에러가 발생했어요.
`Sentry`를 연동해 클라이언트 로그를 확인하면 디버깅할 수 있어요.
자세한 내용은 Sentry 설정하기 가이드를 참고해 주세요.
안드로이드 샌드박스 앱에서 `스키마를 여는데 실패했어요` 에러가 발생해요.
안드로이드 샌드박스 앱 연결을 위해 adb 설정이 필요해요.
자세한 내용은 [가이드](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/development/test/sandbox#_8-%EB%AF%B8%EB%8B%88%EC%95%B1-%EC%8B%A4%ED%96%89%ED%95%98%EA%B8%B0) 를 참고해주세요.
유니티 게임을 앱인토스 미니앱으로 런칭할 수 있나요?
가능해요. 유니티 포팅 가이드 를 참고해 미니앱 환경에 맞게 포팅해주세요.
샌드박스 테스트는 필수인가요?
네. 브라우저 환경에서는 정상적인 테스트가 어려워요.
검수 요청 전 반드시 샌드박스 앱에서 테스트해주세요.
자세한 내용은 [가이드](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/development/test/sandbox) 를 참고해주세요.
`deploymentId를 찾을 수 없어요` 에러가 발생해요.
가이드 에 맞게 `.ait` 파일을 다시 빌드해주세요.
빌드 과정에서 `deploymentId`가 올바르게 포함되어야 해요.
WebView에서 웹 API 사용이 가능한가요?
네. WebView 환경에서 일반적인 웹 API 사용은 제한하지 않아요.
자세한 내용은 WebView 시작하기 가이드를 참고해 주세요.
Storage에 저장된 데이터는 언제 삭제되나요?
앱이 삭제되면 Storage에 저장된 데이터도 함께 삭제돼요.
앱 삭제나 기기 변경 후에도 데이터를 유지해야 한다면 자체 서버와 연동해 주세요.
### 출시 검수
반려 사유가 이해되지 않아요. 구체적으로 어떤 부분이 문제인가요?
반려 시 콘솔에 사유가 안내되며, 해당 사유에 대한 상세 가이드는 개발자센터 검수 가이드라인에서 확인할 수 있어요.
게임 출시 가이드는 [게임 출시 가이드](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/checklist/app-game)를, 비게임 출시 가이드는 [비게임 출시 가이드](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/checklist/app-nongame)를 참고해 주세요.
현재 검수 진행 상태가 어떻게 되나요?
콘솔 > 앱 관리 > 출시 관리에서 현재 검수 상태(접수/검수 중/승인/반려)를 확인할 수 있어요.
자세한 내용은 미니앱 출시 가이드를 참고해 주세요.
반려된 부분 수정했는데 재검수는 어떻게 요청하나요?
콘솔에서 반려 사유에 따라 수정 후, 출시 관리에서 '재검수 요청' 버튼을 누르면 돼요.
재검수도 동일하게 영업일 3\~5일 소요돼요.
자세한 내용은 미니앱 출시 가이드를 참고해 주세요.
앱 출시 검수는 무엇을 확인하나요?
앱 출시 검수는 서비스, 기능, 디자인, 보안을 검토해요.
서비스: 앱인토스 미니앱으로 출시가 가능한 서비스인지 확인해요. 기능: 사용자가 서비스를 정상적으로 이용할 수 있도록 기능이 동작하는지 확인해요. 디자인: 출시 가이드에 따른 정책을 위반하지 않았는지 확인해요. 보안: 앱인토스 보안에 부정적인 영향을 미치는지 확인해요.
게임 출시 가이드는 [게임 출시 가이드](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/checklist/app-game)를, 비게임 출시 가이드는 [비게임 출시 가이드](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/checklist/app-nongame)를 참고해 주세요.
앱 출시 검수는 얼마나 걸리나요?
검토 완료까지 영업일 기준 3\~5일 소요돼요. 주말·공휴일에는 검수가 진행되지 않아요.
자세한 내용은 미니앱 출시 가이드를 참고해 주세요.
앱 번들 업로드의 용량 제한이 있나요?
앱 번들은 압축 해제 기준 100MB 이하만 업로드할 수 있어요.
자세한 내용은 미니앱 출시 가이드를 참고해 주세요.
이미 앱 출시 검토 요청을 한 상태에서 앱의 오류를 발견했는데 어떻게 해야하나요?
현재 앱 출시 검토 요청은 1개의 번들(버전)만 진행할 수 있어요.
오류가 있는 번들의 검토 요청을 취소하고, 재업로드 후에 다시 검토 요청을 하면 돼요.
자세한 내용은 미니앱 출시 가이드를 참고해 주세요.
앱 출시 검수에서 반려되었으면 어떻게 해야하나요?
앱 출시 검수에서 반려되면 반려사유를 통해 어떤 점을 개선해야 하는지 확인할 수 있어요.
반려사유 기반으로 개선한 후, 다시 검토 요청을 하면 돼요.
자세한 내용은 미니앱 출시 가이드를 참고해 주세요.
반려사유에 대해 문의를 할 수 있나요?
반려사유는 콘솔 우측 하단의 채널톡의 상담원 연결을 통해 문의할 수 있어요.
[채널톡 링크](https://apps-in-toss.channel.io/user-chats/69352b8e8d373db4ee2f?page=https%3A%2F%2Fapps-in-toss.channel.io%2Fworkflows%2F787658)
### 마케팅
푸시, 알림의 문구를 작성할 때, 주의할 점이 있나요?
콘솔의 마케팅 도구로서 푸시, 알림은 토스의 앱 자체에서 발송이 이루어지기 때문에, 토스 라이팅 규칙을 지켜야 해요.
관련 가이드는 콘솔 가이드에서 참고해 주세요.
[푸시, 알림의 콘솔 가이드](https://appsintoss.gitbook.io/appsintoss-docs/guide/marketing/intro-1#%EA%B8%B0%EB%B3%B8-%EA%B7%9C%EC%B9%99)
푸시, 알림에서 광고성 메시지와 기능성 메시지의 차이가 무엇인가요?
광고성 메시지와 기능성 메시지는 목적이 다르며, 활용 방법도 달라요.
광고성 메시지: 할인, 이벤트, 신규 상품 안내처럼 마케팅 목적의 프로모션 메시지를 의미해요. 설정한 세그먼트에게 광고성 메시지를 발송할 수 있어요.
기능성 메시지: 서비스 이용 과정에서 발생하는 주문, 결제, 배송 등 필수 정보를 전달하는 메시지를 의미해요. API를 통해서 기능성 메시지를 발송할 수 있어요.
더욱 자세한 가이드는 [푸시, 알림의 콘솔 가이드](https://appsintoss.gitbook.io/appsintoss-docs/guide/marketing/intro-1#%EB%A9%94%EC%8B%9C%EC%A7%80-%EC%9C%A0%ED%98%95) 를 참고해 주세요.
하루에 광고성 푸시는 몇 명에게 보낼 수 있나요?
워크스페이스 기준으로 하루에 광고 푸시를 최대 10만 명에게 발송이 가능하며, 최적화 발송을 통해 가장 알맞은 유저에게 도달하게 돼요.
발송 한도 초과 시 다음 날 자정에 초기화돼요.
자세한 내용은 스마트 발송 콘솔 가이드를 참고해 주세요.
푸시 메시지 검수는 얼마나 걸리나요?
검토 완료까지 영업일 기준 2\~3일 소요돼요.
자세한 내용은 스마트 발송 콘솔 가이드를 참고해 주세요.
알림 수신 동의 문구는 어떻게 작성하나요?
광고성 알림을 발송하려면 유저의 수신 동의를 받아야 해요.
동의 문구에는 다음 내용을 포함해야 하며, 알림 동의문 SDK를 연동해 주세요.
발송 주체(파트너사명)
알림 내용 요약
수신 동의 및 철회 방법 안내
동의 문구 예시와 자세한 내용은 스마트 발송 콘솔 가이드를 참고해 주세요.
프로모션에서 혜택탭 노출을 설정하면 어디에 노출되나요?
토스 > 혜택탭 > 새로운 서비스 써보고에 리스트 형태로 노출돼요.
[프로모션의 이해하기 가이드](https://appsintoss.gitbook.io/appsintoss-docs/guide/marketing/intro-2#%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%EC%9D%B4%EB%9E%80-%EB%AC%B4%EC%97%87%EC%9D%B8%EA%B0%80%EC%9A%94) 를 참고해 주세요.
프로모션 지급 테스트를 꼭 해야 하나요?
프로모션 지급 테스트를 진행해야 '시작하기'를 진행할 수 있어요.
`TEST_{promotionCode}`로 테스트를 완료해야 해요.
자세한 내용은 프로모션 개발하기 가이드를 참고해 주세요.
프로모션에서 중복된 유저에게 지급되지 않도록 막혀있나요?
중복 지급 차단 로직은 직접 구현해야 해요.
관련 내용은 [프로모션의 개발하기 가이드](https://appsintoss.gitbook.io/appsintoss-docs/documentation/common/growth/promotion) 를 참고해 주세요.
스마트발송 소재 검수가 언제 완료되나요?
발송 소재 검수는 영업일 기준 1\~2일 소요돼요.
발송 예정일 최소 3영업일 전에 소재를 등록해 주시는 것을 권장해요.
자세한 내용은 스마트 발송 콘솔 가이드를 참고해 주세요.
스마트발송을 설정했는데 0건 발송이에요.
발송 대상 세그먼트 설정, 발송 시간대, 유저 opt-in 상태를 확인해 주세요.
특히 '기능성 알림'과 '광고성 알림'의 발송 조건이 다르므로, 알림 유형에 맞는 설정이 필요해요.
자세한 내용은 스마트 발송 콘솔 가이드를 참고해 주세요.
대시보드의 데이터는 언제 업데이트 되나요?
대시보드의 데이터는 익일 오전 8시 정도에 업데이트 돼요.
자세한 내용은 대시보드 가이드를 참고해 주세요.
### 수익화
인앱 광고에서 어떤 유형의 광고를 지원하나요?
현재 전면형 광고와 보상형 광고를 지원하고 있어요.
전면형 광고: 광고가 전체화면으로 표시되며, 화면 전환 지점에서 보여줘요.
보상형 광고: '광고를 시청하면 보상 지급'의 구조로, 사용자가 원할 때 광고를 볼 수 있어요.
추후 다양한 광고 유형을 지원할 예정이에요.
자세한 내용은 인앱 광고 이해하기 가이드를 참고해 주세요.
인앱 광고 테스트를 위해서 사용하는 ID가 있나요?
인앱 광고 테스트를 위해서는 반드시 테스트용 ID를 사용해야 해요.
테스트용 ID는 [인앱 광고의 개발하기 가이드](https://appsintoss.gitbook.io/appsintoss-docs/documentation/common/monetization/iaa) 에서 참고해 주세요.
토스페이 Key 발급은 얼마나 걸리나요?
서류 제출 후, 영업일 기준 7\~14일 소요돼요.
자세한 내용은 토스페이 콘솔 가이드를 참고해 주세요.
토스페이 테스트 Key로 승인 테스트가 가능한가요?
테스트 Key로는 결제 생성까지만 활용할 수 있어요.
승인 처리는 불가해요.
자세한 내용은 토스페이 개발하기 가이드를 참고해 주세요.
인앱 결제 가격 제한이 있나요?
인앱 결제 상품의 가격은 최소 400원, 최대 1,400,000원까지 설정할 수 있어요.
자세한 내용은 인앱 결제 이해하기 가이드를 참고해 주세요.
유저가 환불 요청했는데 파트너가 직접 처리할 수 있나요?
네, 콘솔 > 인앱결제 > 결제 내역에서 개별 건의 환불 처리가 가능해요.
환불 정책은 파트너사가 직접 운영하며, 처리 후 유저에게 자동 안내돼요.
자세한 내용은 인앱 결제 콘솔 가이드를 참고해 주세요.
eCPM이 계속 떨어지고 있는데 원인이 뭐가요?
eCPM은 다양한 요인에 따라 변동돼요. 아래 항목을 점검해 보세요.
(1) DAU 변화: 유저 수 감소 시 광고 경쟁률이 낮아져 eCPM이 하락할 수 있어요.
(2) 광고 지면 수: 지면이 너무 많으면 노출당 단가가 낮아질 수 있어요.
(3) 노출 빈도: 같은 유저에게 반복 노출되면 클릭률이 떨어져요. (4) 광고 위치: 유저 동선과 맞지 않는 위치는 효과가 낮아요.
자세한 내용은 인앱 광고 이해하기 가이드를 참고해 주세요.
광고가 아예 안 나와요. 테스트에서는 됐는데 라이브에서 안 돼요.
테스트 키와 라이브 키가 다르게 설정되어 있는지 확인해 주세요.
라이브 환경에서는 광고 지면 승인 완료 후 송출이 시작되며, 승인까지 최대 24시간 소요될 수 있어요.
광고 그룹 ID가 해당 앱에 올바르게 매칭되어 있는지도 확인해 주세요.
자세한 내용은 인앱 광고 개발하기 가이드를 참고해 주세요.
인앱 결제의 환불 처리는 어떻게 진행할 수 있나요?
앱마켓에 따라 환불 처리 방식이 달라요.
Google Play: 48시간 이내 자동 처리돼요. 이후 수동 요청이 가능해요. App Store: 모든 환불은 Apple이 직접 처리해요.
자세한 내용은 인앱 결제 콘솔 가이드를 참고해 주세요.
### 정산
비즈월렛 충전금과 인보이스는 어떻게 확인하나요?
비즈월렛은 광고 푸시 및 프로모션 집행을 위한 선충전 금액이에요.
콘솔 > 워크스페이스 > 비즈월렛에서 확인할 수 있어요. 충전, 사용, 환급 내역은 실시간으로 업데이트 돼요. 인보이스는 익월 1~~2일 이내 업데이트가 완료돼요. 환급은 캠페인 종료 후 1~~2일 이내 자동 반영돼요.
자세한 내용은 정산 이해하기 가이드를 참고해 주세요.
앱인토스 수수료율이 어떻게 되나요?
다만 현재 별도의 수수료는 발생되지 않으며, 추후 발생될 경우 사전 공지해 드릴 예정이에요.
다만 현재 별도의 수수료는 발생 되지 않으며, 추후 발생 될 경우 사전 공지해 드릴 예정이에요.
아래 내용은 참고용으로 확인해 주세요.
(1) 인앱 광고: 광고 수익의 15%가 앱인토스 수수료로 공제 (2) 인앱 결제: 결제 금액 기준 5%가 앱인토스 수수료로 공제 (별도로 앱마켓 수수료 15\~30% 부과) (3) 비즈월렛(광고 푸시/프로모션): 집행 비용 외 별도 수수료 없음 (4) 스마트 발송: 건당 9.9원(vat 포함)
자세한 내용은 정산 이해하기 가이드를 참고해 주세요.
간이과세자도 정산을 받을 수 있나요?
네, 간이과세자도 정산을 받을 수 있어요.
다만 세금계산서 대신 현금영수증을 발행해야 하며, 2회 이상 발급되지 않을 경우 서비스 이용이 제한될 수 있어요.
콘솔 > 워크스페이스 > 내 정보 > 정산 정보에서 사업자 유형을 정확히 등록해 주세요.
자세한 내용은 정산 이해하기 가이드를 참고해 주세요.
광고 푸시 비용은 언제, 어떻게 과금되나요?
광고 푸시는 아래와 같은 방식으로 과금돼요.
등록 시점: 예상 발송 건수 기준 1차 차감 실제 발송 후: 성공 건수 기준으로 재계산 및 차액 환급
세금계산서는 실발송 기준으로 매월 영업일 3일 이내 발행돼요.
자세한 내용은 정산 이해하기 가이드를 참고해 주세요.
정산을 받기 위해서 어떤 정보를 등록해야 하나요?
정산을 받기 위해 콘솔 > 워크스페이스 > 파트너 정보 > 정산 정보에 다음 항목을 등록해야 해요.
사업자 정보 거래 계좌 사본 세금계산서 발행용 이메일
모든 정산은 앱 단위가 아니라 사업자 단위로 합산되어 진행돼요.
자세한 내용은 정산 이해하기 가이드를 참고해 주세요.
인앱 광고 정산은 어떻게 이루어지나요?
인앱 광고는 외부 미디에이션 플랫폼 또는 Toss Ads를 통해 송출되며, 광고 수익에서 앱인토스 수수료 15%가 공제된 금액이 파트너사에게 지급돼요.
자세한 내용은 정산 이해하기 가이드를 참고해 주세요.
인앱 결제 정산은 어떻게 이루어지나요?
인앱 결제는 앱마켓(애플, 구글)과 앱인토스 각각 수수료가 발생해요.
앱마켓 수수료: 공급가 기준 15% 또는 30% 토스 수수료: 결제가 기준 5% (CBT 0%) 지급일: 익월 말 (영업일 기준) 정산내역 제공: 익월 5일 이내
자세한 내용은 정산 이해하기 가이드를 참고해 주세요.
세금계산서 발행은 누가 진행하나요?
정산 항목에 따라 발행 주체가 달라요.
광고 수익 (파트너사 → 토스 발행)
파트너사가 직접 발행 발행일자: 수익 발생월의 말일 이메일: 기한: 매월 영업일 2일 이내
앱인토스 광고 수수료 (토스 → 파트너사 발행)
토스가 선공제 후 발행 발행일: 매월 영업일 3일 이내
인앱 결제 수수료
애플 수수료: 토스가 대신 발행 토스 수수료: 토스가 발행
자세한 내용은 정산 이해하기 가이드를 참고해 주세요.
역발행 세금계산서 승인은 어떻게 하나요? 사업자용 공인인증서가 없어요.
역발행 승인은 팝빌을 통해 진행되며, 사업자용 공동인증서가 필요해요.
인증서가 없는 경우 이번 달만 정발행으로 처리 가능하며, 다음 달부터는 반드시 사업자용 공인인증서를 발급받아 역발행 승인을 진행해 주세요.
자세한 내용은 정산 이해하기 가이드를 참고해 주세요.
정산금이 입금되지 않았어요 / 금액이 달라요.
정산은 월 단위로 진행되며, 익월 말일(인앱광고 및 영업일 기준)에 등록된 계좌로 입금돼요.
정산금이 미입금되거나 금액이 다른 경우 아래를 확인해 주세요:
(1) 세금계산서 미승인: 역발행 세금계산서를 기한 내 승인하지 않으면 해당 월 정산이 익월로 이월돼요. (2) 계좌 정보 오류: 예금주명과 사업자 정보가 일치하는지 확인해 주세요. (3) 앱마켓 직권취소: Google/Apple의 직권취소 건은 정산에서 제외돼요.
자세한 내용은 정산 이해하기 가이드를 참고해 주세요.
정산 계좌를 변경하고 싶어요. 어떻게 하나요?
정산 계좌는 콘솔 > 워크스페이스 > 내 정보 > 정산 정보에서 변경할 수 있어요.
변경 후 익월 정산부터 새 계좌로 적용돼요. 당월 정산이 이미 진행 중이면 기존 계좌로 입금될 수 있어요.
계좌 변경 시 예금주명과 사업자 정보가 일치해야 해요.
문제가 있으면 채널톡으로 문의해 주세요.
자세한 내용은 정산 이해하기 가이드를 참고해 주세요.
사업자 유형이 변경되면 정산에 영향이 있나요?
네, 사업자 유형(일반과세자/간이과세자/법인)이 변경되면 세금계산서 발행 방식이 달라져요. 변경 사항은 채널톡으로 문의해 주세요.
변경 사항은 익월 정산부터 반영돼요.
개인→법인 변경 등에 따른 사업자번호가 달라지면 워크스페이스를 새로 만들어야 해요.
자세한 내용은 정산 이해하기 가이드를 참고해 주세요.
구글 기프트카드로 결제된 건은 어떻게 처리해야 하나요?
구글 기프트카드 결제는 현금영수증 의무가 있어요.
2025.12.01 이후 토스에서 자동 대행 발행해요. 결제내역에서 기프트카드 여부 확인이 가능해요. 앱마켓 직권취소로 정산에서 제외되어도, 현금영수증을 취소하지 말아야 해요. 익월 초 제공되는 정산 리포트를 참고해서 처리해 주세요.
자세한 내용은 정산 이해하기 가이드를 참고해 주세요.
### 홍보
토스 로고는 어떻게 사용할 수 있나요?
토스 로고는 보도자료 가이드와 외부 광고 가이드에 따라, 색상과 비율을 변경하지 않고 사용해야 해요.
자세한 내용은 보도자료 가이드를 참고해 주세요.
보도자료에서 \'입점\'이라는 표현을 사용할 수 있나요?
보도자료에서는 '입점'이 아닌, '토스 제휴'로 표기해야 해요.
그리고 채널톡 문의를 통해 사전 검토 요청 후 승인을 받고 배포해야 해요.
자세한 내용은 보도자료 가이드를 참고해 주세요.
### 서비스 종료
앱 서비스를 종료/삭제하고 싶어요. 절차가 어떻게 되나요?
채널톡으로 앱 ID와 종료 사유를 알려주시면 운영팀에서 종료 절차를 안내해 드려요.
종료 시 기존 유저 안내, 정산 마무리 등의 후속 절차가 있으니 최소 2주 전에 문의해 주세요.
자세한 내용은 서비스 종료하기 가이드를 참고해 주세요.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://developers-apps-in-toss.toss.im/guide/faq.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.