> 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/en/faq.md).
# FAQ
{% hint style="info" %}
**Please check**
The FAQ content may change due to reasons such as operational policy updates and console feature updates. For development inquiries not covered in the FAQ, please contact [the Developer Community](https://techchat-apps-in-toss.toss.im/), and for operational inquiries, please contact [Channel Talk](https://apps-in-toss.channel.io/workflows/787658).
{% endhint %}
### App in Toss service
What is App in Toss?
App in Toss is a platform where partner companies can launch mini-app services they developed inside the Toss app in an 'app-in-app' (App-in-App) format.
You can easily develop with SDKs based on WebView, Unity, and React Native, and also make use of the Toss Design System (TDS). You can also run effective marketing using push notifications, alerts, and promotions.
What features does App in Toss provide?
Through Toss's SDKs, APIs, and UI components, you can quickly implement core features such as login, payment, and authentication.
It provides an integrated solution covering development environment, design, marketing, monetization, and settlement.
Are there any services that cannot be opened as an App in Toss mini app?
Some services are restricted from being opened on App in Toss according to Toss platform policies, relevant laws, and user protection standards.
Related information can be found in [the Service Launch Policy ](/landing-page/landing-page-en/intro/guide.md).
How long does it take from App in Toss mini app development to launch?
It takes about 2 to 4 weeks for game services and about 1 to 3 months for non-game services.
The schedule may vary depending on the service type, feature scope, and review process.
Who can use the App in Toss mini app service?
The App in Toss mini app service is provided to users aged 19 and older.
It can be used in environments running Android 7 or later, or iOS 16 or later.
I want to register my service on App in Toss. What is the process?
The process is Console sign-up → Workspace creation → Business registration → App registration → Review request.
You can find step-by-step guidance in the Getting Started document in the Developer Center.
Where can I find App in Toss webinar materials?
App in Toss webinar materials are available in the App in Toss Console and [the Business Admin Academy](https://business.toss.im/dashboard/business-academy).
### App registration
What information is needed to register an app?
The required information differs depending on whether it is a game service or a non-game service.
You mainly fill in the service planning details.
* Game: app logo, app name, appName, customer support email, category, rating information, app search keywords, game app description, thumbnail, leaderboard, etc.
* Non-game: app logo, app name, appName, customer support email, category, app description, app search keywords, etc.
For more details, please refer to the app registration guide in the Console.
How long does app registration review take?
It takes 1 to 2 business days to complete the review.
For more details, please refer to the app registration guide in the Console.
Can't appName be modified or deleted?
appName is the same concept as the app ID.
The app ID is registered in the app information and cannot be modified or deleted.
For more details, please refer to the app registration guide in the Console.
How can I get the rating review for a game service?
To launch a game mini app, a 'game rating classification' is required.
According to the Act on Promotion of the Game Industry, to produce and distribute a game for the purpose of distribution or service, you must obtain a rating classification. Legally, games that have not received a rating before official launch cannot be released as a service.
To register rating information, you need a store link or documents from the Game Rating and Administration Committee.
How to obtain rating classification from the store and the Game Rating and Administration Committee is [the blog on the official App in Toss website](https://toss.im/apps-in-toss/blog/game_rating_classification).
According to the Act on Promotion of the Game Industry, to produce and distribute a game for the purpose of distribution or service, you must obtain a rating classification.
Legally, games that have not received a rating before official launch cannot be released as a service.
To register rating information, you need a store link or documents from the Game Rating and Administration Committee. How to obtain rating classification from the store and the Game Rating and Administration Committee is [the blog on the official App in Toss website](https://toss.im/apps-in-toss/blog/game_rating_classification) .
How long does business registration review take?
It takes 1 business day to complete the review.
You can check the review result in the Console.
For more details, please refer to the business registration guide.
I need to change or additionally submit my business registration certificate. What should I do?
You can upload your business registration certificate in Console > Settings > Business Information.
A re-review is required for changes, and it takes 1 to 2 business days.
When changing from an individual to a corporation, if the business registration number changes, you need to create a new workspace.
For more details, please refer to the business registration guide.
Can I launch an app without a business registration?
You can launch an app even without a business registration.
However, if you do not have a business registration, you cannot use some features for contracts and settlement.
Features that require business registration: Toss Login, Biz Wallet, Promotions, in-app ads, Toss Pay, in-app payments
For more details, please refer to the business registration guide.
### Design
Are there any policies regarding dark patterns in App in Toss mini app design?
Mini apps with dark pattern designs that create expectations beyond what customers anticipate cannot be launched.
Typical examples of dark patterns are as follows.
* When a bottom sheet appears as soon as the user enters the service
* When pressing the Back button causes a bottom sheet to appear and block the previous screen
* When there is no way to exit
* When ads appear at unexpected moments
* When users cannot predict what action they should take after seeing the CTA button
For more details, please refer to [the Dark Pattern Prevention Policy Guide](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/design/consumer-ux-guide).
What is TDS?
TDS stands for Toss Design System, and it is the design system used in the Toss community.
TDS is a design language that builds Toss products and enables collaboration across roles, and it is also a tool for developers.
Using TDS provides users with a consistent product experience while allowing designers to focus only on solving problems.
Development can also be completed 3 to 5 times faster than with custom UI.
Related information can be found in [Toss Design System guide in the design section of the Developer Center](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/design/components) .
Are there any precautions before using TDS?
Please note the following to use TDS safely and correctly.
Intellectual property rights: All rights to materials provided by Toss through the App in Toss service belong to Toss. Partner companies may use those materials only within the scope of using the App in Toss service.
Usage rights: Toss's permission to use TDS grants a limited license for providing the App in Toss service. Therefore, partner companies cannot obtain results or rights that exceed this scope.
Compliance obligations and actions in case of violations: Partner companies must comply with these terms and relevant laws. If a partner company violates them, Toss may suspend the App in Toss service or take other necessary actions.
For more details, please refer to the Figma/TDS UI License Guide.
What is App Builder?
App Builder is a UI design tool for App in Toss partners.
You can quickly complete screens that follow Toss's UI style guide without any special installation.
Related information can be found in [App Builder guide in the design section of the Developer Center](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/design/prepare/design) .
Do App in Toss mini apps support dark mode in system mode?
Currently, App in Toss mini apps do not support dark mode.
You should develop, design, and launch based on light mode.
Where can I get Figma resources?
You can find them in the Figma guide in the design section of the Developer Center.
Is TDS required?
It is not mandatory to design every component with TDS.
However, for a consistent user experience, using TDS is recommended as much as possible, and areas that are difficult to implement with TDS should be developed in-house.
For more details, please refer to the Toss Design System Guide.
Can you provide the Toss Products Sans font?
The Toss Products Sans font is not provided separately.
To apply the Toss Products Sans font, please use TDS components.
For more details, please refer to the Toss Design System Guide.
### Development
I already have a service in operation. How do I deploy it as an App in Toss mini app?
After developing the client side of your existing service to fit the App in Toss environment, you can connect it with your own backend server as needed.
For more details, [the guide](/ai-vibe-coding/en/tutorials/webview.md).
Do I need to migrate to SDK 3.x? By when?
Yes, all partner companies currently operating WebView and Unity projects must update to SDK 3.x by September 14, 2026.
As the SDK's internal processing logic has changed to be server-based, even if an SDK issue occurs, it can be fixed and applied directly on the App in Toss server without the partner company's redeployment.
For Unity SDK, the transition is completed by updating the git package to version 3.x without any separate configuration changes.
For more details, [SDK 3.x Migration Guide](/documentation/api-and-sdk-en/integration/sdk-3.x-migration.md).
Do I need to implement the navigation bar myself?
No. When you install the App in Toss SDK, the default navigation bar is applied automatically.
Non-game mini apps can `navigationBar` option to customize whether back/home buttons are shown, background transparency, theme (light/dark), accessory icons, and more.
For more details, [Please refer to the navigation bar setup guide.](/documentation/api-and-sdk-en/common/navigationbar.md) Please refer to it.
Is a server absolutely necessary for App in Toss development?
No. You can develop a mini app with only the SDK, without a separate server.
You only need your own server when using features that require server-to-server communication, such as Toss Login, Toss Pay, and Smart Sending. In that case, you can additionally configure server API integration settings such as mTLS, CORS, and firewall.
For more details,[ API Usage Guide](/documentation/api-and-sdk-en/integration/server-api.md).
A CORS error occurs when calling an external API.
To communicate with the server in a mini app, you need to add the mini app Origin to the server's allowed CORS Origin.\
The Origin that needs to be allowed differs depending on the SDK version and application date.
{% hint style="info" %}
**SDK 3.x Origin Change Notice**
Starting with SDK 3.x bundles uploaded after Tuesday, August 25, 2026, the service will run using the Origin used in SDK 2.x.\
If you communicate with an external server, please add the Origin below to the server's allowed CORS Origin.
* `https://.apps.tossmini.com` : live service environment
* `https://.private-apps.tossmini.com` : Console QR test environment
{% endhint %}
| SDK version | Live service environment | QR test environment |
| ----------- | ------------------------------------- | --------------------------------------------- |
| 3.x | `https://.web.tossmini.com` | `https://.private-web.tossmini.com` |
| 1.x\~2.x | `https://.apps.tossmini.com` | `https://.private-apps.tossmini.com` |
For more details, [Mini App Launch Guide](/guide/en/operation/deploy.md).
Is mTLS authentication required?
Yes. mTLS authentication is required for server-to-server communication in the App in Toss API.
If not applied, `ERR_NETWORK` an error may occur.
For more details, [API Usage Guide](/documentation/api-and-sdk-en/integration/server-api.md).
Are there any IPs that need to be allowed in the firewall?
Yes. If your server manages inbound and outbound firewalls, you must allow App in Toss IPs.
If not allowed, API calls may fail, or you may not receive subscription status change callbacks to the callback URL registered in the Console.
For the detailed IP and port list, [API Usage Guide](/documentation/api-and-sdk-en/integration/server-api.md).
Is there a limit on the number of API requests?
Yes. The App in Toss API allows up to 3,000 requests per minute (QPM, Queries Per Minute) per mini app.
If you exceed the limit, additional requests may be blocked for a period of time.
If you need more requests, [Channel Talk](https://apps-in-toss.channel.io/workflows/787658)you can request a QPM increase there. Please also provide the purpose of use, estimated traffic volume, and request volume during peak times.
For more details, [API Usage Guide](/documentation/api-and-sdk-en/integration/server-api.md).
Are there any security checks to consider when developing a mini app?
Yes, please check the following.
* Features that execute code received from outside cannot be used. (e.g., `eval` etc.)
* Methods that manipulate browser history to redirect users to your own site cannot be used. (e.g., `window.location.replace` etc.)
* Server-side rendering (SSR) cannot be used. Only client-side rendering (CSR) or static site generation (SSG) can be used.
* When using WebSocket, use only encrypted `wss://` connections. (e.g., Firebase Firestore, Supabase Realtime, etc.)
* API communication must use encrypted HTTPS connections only.
* Sensitive information such as user login information and payment records (Toss Pay, in-app payments) must be stored in the database in encrypted form.
* You must properly manage users' consent history, such as Toss Login and terms agreement.
* We also recommend encrypting personal data when sending it from the client to your own server.
It worked normally in the test environment, but API calls fail in the live environment.
HTTP requests are allowed in test environments (sandbox, AIT Devtools, etc.), but only HTTPS is allowed in the live environment. HTTP-based APIs are blocked in the Toss app.
Please check whether the API server supports HTTPS.
For more details, [Mini App Testing Guide](/guide/en/operation/toss.md).
The login session is not maintained on iOS.
On iOS and iPadOS 13.4 or later, third-party cookies are completely blocked.
Please apply a token-based authentication method instead of cookie-based login.
For more details, [Mini App Testing Guide](/guide/en/operation/toss.md).
An error occurred during QR testing.
`Sentry`You can debug by integrating it and checking the client logs.
For more details, please refer to the Sentry setup guide.
An error saying `Failed to open schema` occurs in the Android sandbox app.
ADB setup is required to connect the Android sandbox app.
For more details, [the guide](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) .
Can I launch a Unity game as an App in Toss mini app?
Yes. If you build a Unity game with WebGL, you can turn it into an App in Toss mini app.
If you install the App in Toss Unity SDK (Unity package), you can handle everything from WebGL build to `.ait` packaging at once, without having to set up a separate Vite project or implement a JS Bridge. Unity 2021.3 or later is supported.
For more details, [Unity SDK Integration Guide](/documentation/api-and-sdk-en/unity/integration.md).
What are the benefits of using the App in Toss Unity SDK?
Using the App in Toss Unity SDK (Unity package) provides the following benefits.
* **Short porting period**: You can port to a mini app easily and quickly without setting up a separate Vite project or implementing a JS Bridge.
* **Improved stability and user experience**: Reduces loading time to about one-fifth.
* **More performance metrics available**: You can check various game performance metrics such as crash rate, loading time, and FPS.
* **Built-in loading screen**: The loading screen is included by default in the SDK without any separate setup.
There is also a case where a game that had a loading time of about 20 seconds when using a manual porting method, causing many user drop-offs and CS inquiries, reduced its loading time to 1 second after switching to the Unity SDK.
For more details, [Unity SDK Integration Guide](/documentation/api-and-sdk-en/unity/integration.md).
Is sandbox testing mandatory?
When using SDK 2.x, you must test in the sandbox app. React Native currently supports only SDK 2.x, so you must test in the sandbox app.
If you have migrated to SDK 3.x in WebView, you can test in a local browser using AIT Devtools. (Manual configuration is required only if you migrated from SDK 3.0.1.) WebView projects that are still using SDK 2.x must also be tested in the sandbox app.
For more details, [the guide](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/development/test/sandbox)and [SDK 3.x Migration Guide](/documentation/api-and-sdk-en/integration/sdk-3.x-migration.md).
`deploymentId not found` error occurs.
Please rebuild the file according to the guide. `.ait` During the build process,
deploymentId `must be included correctly.`Can web APIs be used in WebView?
Yes. We do not restrict the use of general web APIs in the WebView environment.
When is data stored in Storage deleted?
When the app is deleted, the data stored in Storage is also deleted.
If you need to keep data even after app deletion or device changes, please connect it with your own server.
Launch review
### I don't understand the reason for rejection. What exactly is the problem?
If rejected, the reason will be provided in the Console, and detailed guidance for that reason can be found in the Developer Center review guidelines.
The game launch guide can be found in the
Game Launch Guide [game launch guide, and the non-game launch guide can be found in the](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/checklist/app-game)Non-game Launch Guide [.](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/checklist/app-nongame).
What is the current review status?
You can check the current review status (received / under review / approved / rejected) in Console > App Management > Launch Management.
For more details, please refer to the Mini App Launch Guide.
I fixed the rejected parts. How do I request re-review?
In the Console, after making changes according to the rejection reason, click the 'Request Re-review' button in Launch Management.
Re-review also takes 3 to 5 business days.
For more details, please refer to the Mini App Launch Guide.
What does app launch review check?
App launch review checks the service, functionality, design, and security.
Service: We check whether the service can be launched as an App in Toss mini app. Functionality: We check whether the features work properly so users can use the service normally. Design: We check whether any policies in the launch guide are violated. Security: We check whether there is any negative impact on App in Toss security.
Game Launch Guide [game launch guide, and the non-game launch guide can be found in the](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/checklist/app-game)Non-game Launch Guide [.](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/checklist/app-nongame).
How long does app launch review take?
It takes 3 to 5 business days to complete the review. Reviews are not conducted on weekends or public holidays.
For more details, please refer to the Mini App Launch Guide.
Is there a size limit for app bundle uploads?
App bundles can be uploaded only if the uncompressed size is 100 MB or less.
For more details, please refer to the Mini App Launch Guide.
I found an error in the app after already requesting launch review. What should I do?
Currently, only one bundle (version) can be under app launch review.
Cancel the review request for the bundle with the error, re-upload it, and then request review again.
For more details, please refer to the Mini App Launch Guide.
What should I do if the app is rejected in launch review?
If the app is rejected in launch review, you can check what needs to be improved through the rejection reason.
After improving based on the rejection reason, request review again.
For more details, please refer to the Mini App Launch Guide.
Can I inquire about the rejection reason?
You can inquire about the rejection reason through the Channel Talk counselor connection at the bottom right of the Console.
[Channel Talk link](https://apps-in-toss.channel.io/user-chats/69352b8e8d373db4ee2f?page=https%3A%2F%2Fapps-in-toss.channel.io%2Fworkflows%2F787658)
### Marketing
Are there any precautions when writing push and alert messages?
As push notifications and alerts are marketing tools in the Console and are sent from Toss's own app, you must follow Toss writing rules.
Please refer to the related guide in the Console guide.
[Console guide for push notifications and alerts](https://appsintoss.gitbook.io/appsintoss-docs/guide/marketing/intro-1#%EA%B8%B0%EB%B3%B8-%EA%B7%9C%EC%B9%99)
What is the difference between promotional messages and functional messages in push notifications and alerts?
Promotional messages and functional messages have different purposes and are used differently.
Promotional messages: These are marketing promotion messages such as discounts, events, and new product announcements. You can send promotional messages to the configured segment.
Functional messages: These are messages that deliver essential information that occurs during service use, such as orders, payments, and deliveries. Functional messages can be sent through the API.
For more detailed guidance, [Console guide for push notifications and alerts](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) .
How many users can receive promotional pushes per day?
Based on the workspace, promotional pushes can be sent to up to 100,000 users per day, and optimized delivery ensures they reach the most appropriate users.
If the sending limit is exceeded, it resets at midnight the next day.
For more details, please refer to the Smart Sending Console Guide.
How long does push message review take?
It takes 2 to 3 business days to complete the review.
For more details, please refer to the Smart Sending Console Guide.
How should I write the consent text for receiving alerts?
To send promotional alerts, you must obtain the user's consent to receive them.
The consent text must include the following information, and please integrate the alert consent SDK.
Sender (partner company name)
Summary of alert content
Instructions for consent and withdrawal methods
For sample consent text and more details, please refer to the Smart Sending Console Guide.
If I set promotion exposure in the Benefits tab, where will it appear?
It will appear as a list in Toss > Benefits tab > Try out new services.
[Promotion Getting Started Guide](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) .
Is promotion reward testing mandatory?
You must complete the promotion reward test before you can proceed with 'Getting Started'.
`TEST_{promotionCode}`must be used to complete the test.
For more details, please refer to the Promotion Development Guide.
Is there a block to prevent rewards from being given to duplicate users in promotions?
You must implement the duplicate reward prevention logic yourself.
Related information can be found in [Promotion Development Guide](https://appsintoss.gitbook.io/appsintoss-docs/documentation/common/growth/promotion) .
When will the Smart Sending creative review be completed?
The sending creative review takes 1 to 2 business days.
We recommend registering the creative at least 3 business days before the scheduled sending date.
For more details, please refer to the Smart Sending Console Guide.
I set up Smart Sending, but zero messages were sent.
Please check the target segment settings, sending time, and the user's opt-in status.
In particular, the sending conditions for 'functional alerts' and 'promotional alerts' are different, so the settings must match the alert type.
For more details, please refer to the Smart Sending Console Guide.
When is the data on the dashboard updated?
The dashboard data is updated around 8:00 AM the next day.
For more details, please refer to the dashboard guide.
### Monetization
What types of ads are supported in in-app ads?
Currently, interstitial ads and rewarded ads are supported.
Interstitial ads: Ads are displayed in full screen and shown at screen transition points.
Rewarded ads: A structure where 'watch an ad and receive a reward' allows users to watch ads whenever they want.
More ad types will be supported in the future.
For more details, please refer to the in-app ads guide.
Is there an ID used for in-app ad testing?
You must use a test ID for in-app ad testing.
Please refer to [the in-app ads development guide](https://appsintoss.gitbook.io/appsintoss-docs/documentation/common/monetization/iaa) .
How long does it take to issue a Toss Pay Key?
After submitting the documents, it takes 7–14 business days.
For more details, please refer to the Toss Pay Console Guide.
Can I run approval tests with a Toss Pay test Key?
The test Key can only be used up to payment creation.
Approval processing is not available.
For more details, please refer to the Toss Pay Development Guide.
Is there a price limit for in-app purchases?
The price of in-app purchase products can be set from a minimum of 400 KRW to a maximum of 1,400,000 KRW.
For more details, please refer to the Understanding In-App Purchases Guide.
A user requested a refund—can the partner process it directly?
Yes, you can process refunds for individual cases in Console > In-App Payments > Payment History.
The refund policy is operated directly by the partner company, and the user will be automatically notified after processing.
For more details, please refer to the In-App Purchase Console Guide.
eCPM keeps dropping—what's causing it?
eCPM fluctuates depending on various factors. Please check the items below.
(1) DAU change: If the number of users decreases, ad competition may weaken and eCPM may drop.
(2) Number of ad placements: If there are too many placements, the cost per impression may decrease.
(3) Impression frequency: Repeated exposure to the same user lowers click-through rate. (4) Ad placement: Locations that do not match the user flow are less effective.
For more details, please refer to the in-app ads guide.
Ads aren't showing at all. They worked in test, but not in live.
Please check whether the test Key and live Key are set differently.
In the live environment, ads start delivering after ad placement approval is complete, and approval can take up to 24 hours.
Please also check whether the ad group ID is correctly matched to the app.
For more details, please refer to the In-App Ads Development Guide.
How can refund processing for in-app purchases be handled?
The refund process varies depending on the app market.
Google Play: Automatically processed within 48 hours. Manual requests are possible afterward. App Store: All refunds are handled directly by Apple.
For more details, please refer to the In-App Purchase Console Guide.
### Settlement
How do I check Biz Wallet top-ups and invoices?
Biz Wallet is a prepaid amount used for ad pushes and promotions.
You can check it in Console > Workspace > Biz Wallet. Top-up, usage, and refund details are updated in real time. Invoices are updated by the 1~~They are completed within 2 days. Refunds are automatically reflected within 1~~2 days after campaign completion.
For more details, please refer to the Understanding Settlement Guide.
What is the App in Toss fee rate?
However, there are currently no separate fees, and if any are introduced in the future, we will notify you in advance.
However, there are currently no separate fees, and if any are introduced in the future, we will notify you in advance.
Please refer to the following information as a guide.
(1) In-app ads: 15% of ad revenue is deducted as the App in Toss fee (2) In-app purchases: 5% of the payment amount is deducted as the App in Toss fee (app market fees of 15–30% are charged separately) (3) Biz Wallet (ad push/promotions): No separate fee other than execution cost (4) Smart sending: 9.9 KRW per item (VAT included)
For more details, please refer to the Understanding Settlement Guide.
Can simplified taxpayers also receive settlements?
Yes, simplified taxpayers can also receive settlements.
However, instead of a tax invoice, you must issue a cash receipt, and if it is not issued at least twice, service use may be restricted.
Please register your business type accurately in Console > Workspace > My Info > Settlement Info.
For more details, please refer to the Understanding Settlement Guide.
When and how are ad push costs charged?
Ad push is charged in the following way.
At registration: First deduction based on the estimated number of sends After actual sending: Recalculated based on successful sends and the difference refunded
Tax invoices are issued within 3 business days each month based on actual sends.
For more details, please refer to the Understanding Settlement Guide.
What information do I need to register to receive settlements?
To receive settlements, you need to register the following items under Console > Workspace > Partner Info > Settlement Info.
Business information Bank account copy Email for tax invoice issuance
All settlements are processed by business entity, not by app.
For more details, please refer to the Understanding Settlement Guide.
How are in-app ad settlements handled?
In-app ads are delivered through an external mediation platform or Toss Ads, and 15% App in Toss fee is deducted from ad revenue before the remaining amount is paid to the partner company.
For more details, please refer to the Understanding Settlement Guide.
How are in-app purchase settlements handled?
In-app purchases incur fees from both the app market (Apple, Google) and App in Toss.
App market fee: 15% or 30% based on supply price Toss fee: 5% based on payment amount (0% for CBT) Payment date: End of next month (business days 기준) Settlement details provided: within the first 5 days of next month
For more details, please refer to the Understanding Settlement Guide.
Who issues the tax invoice?
The issuing party differs depending on the settlement item.
Ad revenue (issued by partner company to Toss)
Issued directly by the partner company Issuance date: Last day of the month in which revenue was generated Email: Deadline: Within 2 business days each month
App in Toss ad fee (issued by Toss to partner company)
Issued by Toss after pre-deduction Issuance date: Within 3 business days each month
In-app purchase fee
Apple fee: Issued on behalf of Toss Toss fee: Issued by Toss
For more details, please refer to the Understanding Settlement Guide.
How do I approve a reverse-issued tax invoice? I don't have a business certificate.
Reverse issuance approval is handled through Popbill, and a business joint certificate is required.
If you don't have a certificate, you can process it as a regular issuance only for this month. Starting next month, please обязательно obtain a business certificate and proceed with reverse issuance approval.
For more details, please refer to the Understanding Settlement Guide.
The settlement amount was not deposited / the amount is different.
Settlements are processed monthly and deposited to the registered account on the last day of the following month (for in-app ads and based on business days).
If the settlement amount has not been deposited or the amount is different, please check the following:
(1) Unapproved tax invoice: If you do not approve the reverse-issued tax invoice within the deadline, that month's settlement is carried over to the following month. (2) Bank account information error: Please check whether the account holder name matches the business information. (3) App market ex officio cancellation: Cases canceled ex officio by Google/Apple are excluded from settlement.
For more details, please refer to the Understanding Settlement Guide.
I want to change the settlement account. How do I do it?
You can change the settlement account in Console > Workspace > My Info > Settlement Info.
After the change, it will be applied to the settlement for the following month. If the current month's settlement is already in progress, it may be deposited to the existing account.
When changing the account, the account holder name and business information must match.
If there's a problem, please contact us via Channel Talk.
For more details, please refer to the Understanding Settlement Guide.
Does changing the business type affect settlement?
Yes, if the business type (general taxpayer/simplified taxpayer/corporation) changes, the tax invoice issuance method also changes. Please contact us via Channel Talk for any changes.
The changes will be reflected starting with next month's settlement.
If the business registration number changes due to a change from individual to corporation, you need to create a new workspace.
For more details, please refer to the Understanding Settlement Guide.
How should purchases made with Google gift cards be handled?
Google gift card payments require a cash receipt.
Starting from 2025.12.01, Toss will automatically issue it on your behalf. You can check whether it was a gift card in the payment history. Even if it is excluded from settlement due to app market ex officio cancellation, you must not cancel the cash receipt. Please refer to the settlement report provided at the beginning of next month.
For more details, please refer to the Understanding Settlement Guide.
### Promotion
How can I use the Toss logo?
The Toss logo must be used without changing its color or proportions, in accordance with the press release guide and external advertising guide.
For more details, please refer to the Press Release Guide.
Can I use the term 'store opening' in a press release?
In press releases, you should use 'Toss partnership' instead of 'store opening.'
Also, you must request a prior review through Channel Talk, get approval, and then distribute it.
For more details, please refer to the Press Release Guide.
### Service termination
I want to terminate/delete the app service. What is the procedure?
If you let us know the app ID and reason for termination via Channel Talk, the operations team will guide you through the termination process.
When terminating, there are follow-up steps such as notifying existing users and completing settlements, so please contact us at least 2 weeks in advance.
For more details, please refer to the Service Termination Guide.
---
# 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/en/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.