> 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).
# Frequently asked questions
{% hint style="info" %}
**Please check.**
The content of the FAQ may change due to reasons such as policy revisions and console feature updates. Development inquiries not covered in the FAQ are [Developer Community](https://techchat-apps-in-toss.toss.im/), and operational inquiries are [Channel Talk](https://apps-in-toss.channel.io/workflows/787658)please contact us through.
{% endhint %}
### Apps in Toss service
What kind of service is Apps in Toss?
Apps in Toss is a platform that lets partner companies launch mini app services they developed inside the Toss app in an 'app-in-app (App-in-App)' format.
You can easily develop using WebView, Unity, and React Native-based SDKs, and you can also use the Toss Design System (TDS). You can also run effective marketing using push notifications, alerts, promotions, and more.
What features does Apps in Toss provide?
Through Toss's SDK, API, UI components, and more, you can quickly implement core features such as login, payment, and authentication.
We provide an integrated solution from development environment and design to marketing, monetization, and settlement.
Are there services that cannot be opened as an Apps in Toss mini app?
Under the Toss platform policy, relevant laws, and user protection standards, there are services whose launch is restricted.
Relevant details can be found [service launch policy ](/landing-page/landing-page-en/intro/guide.md)here.
How long does it take from mini app development to launch in Apps in Toss?
Game services take about 2-4 weeks, and non-game services about 1-3 months.
The schedule may vary depending on the service type, feature scope, and review process.
Who can use the Apps in Toss mini app service?
The Apps 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 in Apps in Toss. What is the process?
It proceeds in the order of console sign-up → create workspace → business registration → app registration → request review.
You can check the step-by-step guide in the Developer Center's Getting Started document.
Where can I find the Apps in Toss webinar materials?
The Apps in Toss webinar materials are available in the Apps in Toss console and [Business Admin Academy](https://business.toss.im/dashboard/business-academy).
### App registration
What information is needed to register an app?
The information you need to fill out 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 inquiry email, category, rating information, app search keywords, game app description, thumbnail, leaderboard, etc.
* Non-game: app logo, app name, appName, customer inquiry email, category, app description, app search keywords, etc.
For details, please refer to the app registration guide in the console.
How long does app registration review take?
It takes 1-2 business days to complete the review.
For 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 edited or deleted.
For 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, if you create 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 release cannot launch the service.
To register rating information, you need a store link or documents from the Game Rating and Administration Committee.
How to get a rating classification from the store and the Game Rating and Administration Committee is [the blog on the official Apps in Toss website](https://toss.im/apps-in-toss/blog/game_rating_classification)here.
According to the Act on Promotion of the Game Industry, if you create 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 release cannot launch the service.
To register rating information, you need a store link or documents from the Game Rating and Administration Committee. How to get a rating classification from the store and the Game Rating and Administration Committee is [the blog on the official Apps in Toss website](https://toss.im/apps-in-toss/blog/game_rating_classification) here.
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 details, please refer to the business registration guide.
How do I submit a changed/additional business registration certificate?
You can upload the business registration certificate in Console > Settings > Business Information.
A re-review is required when changes are made, and it takes 1-2 business days.
If switching from an individual to a corporation causes the business registration number to change, you need to create a new workspace.
For details, please refer to the business registration guide.
Can I launch an app without a business registration?
You can launch an app without a business registration.
However, without a business registration, some features cannot be used for contracts and settlement.
Features that require a business registration: Toss Login, Biz Wallet, promotions, in-app ads, Toss Pay, in-app purchases
For details, please refer to the business registration guide.
### Design
Is there a policy regarding dark patterns in Apps in Toss mini app design?
Mini apps with dark pattern designs that go beyond customer expectations cannot be launched.
Typical examples of dark patterns are as follows.
* When a bottom sheet appears as soon as you enter the service
* When pressing the Back button brings up a bottom sheet that blocks the previous screen
* When there is no way to exit
* When ads appear at unexpected moments
* When the user cannot predict what action they need to take after seeing a CTA button
For details, please refer to the [Dark Pattern Prevention Policy Guide](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/design/consumer-ux-guide)in the design section of the Developer Center.
What is TDS?
TDS stands for Toss Design System, and is the design system used in the Toss community.
TDS is a design language that composes Toss products and enables cross-functional collaboration, and it is also a tool for developers.
Using TDS lets designers focus only on problem solving while providing users with a consistent product experience.
Development can also be completed 3 to 5 times faster than with custom UI.
Relevant details can be found [Toss Design System guide in the design section of the Developer Center](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/design/components) in the design section of the Developer Center.
Are there any precautions before using TDS?
To use TDS safely and correctly, please note the following.
Intellectual property rights: All materials provided by Toss through the Apps in Toss service belong to Toss. Partners may use those materials only within the scope of using the Apps in Toss service.
Usage rights: Toss's permission to use TDS grants a limited license for providing the Apps in Toss service. Therefore, partners cannot obtain deliverables or rights beyond this scope.
Compliance obligations and actions in case of violation: Partners must comply with these terms and relevant laws. If a partner violates them, Toss may suspend the provision of the Apps in Toss service or take other necessary measures.
For details, please refer to the Figma/TDS UI license guide.
What is App Builder?
App Builder is a UI design tool for Apps in Toss partners.
Without any special installation, you can quickly complete screens that follow Toss's UI style guide.
Relevant details can be found [App Builder guide in the design section of the Developer Center](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/design/prepare/design) in the design section of the Developer Center.
Does the Apps in Toss mini app support dark mode in system mode?
Currently, Apps in Toss mini apps do not support dark mode.
You need to 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 mandatory?
It is not necessary to design every component with TDS.
However, for a consistent user experience, we recommend using TDS whenever possible, and for areas that are difficult to solve with TDS, please build them yourself.
For 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 typeface, please use TDS components.
For details, please refer to the Toss Design System guide.
### Development
I already have a service in operation. How do I deploy it as an Apps in Toss mini app?
After developing the client side to fit the existing service into the Apps in Toss environment, you can integrate it with your own backend server as needed.
For details, please refer to the [guide](/ai-vibe-coding/en/tutorials/webview.md).
Do I need to migrate to SDK 3.x? By when do I need to do it?
Yes, all partners operating WebView and Unity projects must update to SDK 3.x by September 14, 2026.
As the internal processing logic of the SDK is being changed to server-based, even if an SDK issue occurs, it can be fixed and applied directly on the Apps in Toss server without the partner's redeployment.
For Unity SDK, the transition is complete once you update the git package to version 3.x without changing any separate settings.
For details, please refer to the [SDK 3.x migration guide](/documentation/api-and-sdk-en/integration/sdk-3.x.md)in the design section of the Developer Center.
Do I need to implement the navigation bar myself?
No. When you install the Apps in Toss SDK, the default navigation bar is applied automatically.
Non-game mini apps `navigationBar` as an option, you can customize whether the back/home buttons are shown, background transparency, theme (light/dark), accessory icons, and more.
For details, please refer to the [Please refer to the navigation bar settings guide.](/documentation/api-and-sdk-en/common/navigationbar.md) .
Is a server absolutely necessary for Apps in Toss development?
No. You can develop mini apps with just the SDK, without a separate server.
Only when using features that require server-to-server communication, such as Toss Login, Toss Pay, and smart sending, do you need your own server, and in that case you can additionally set up server API integration settings such as mTLS, CORS, and firewall.
For details, please refer to the[ API usage guide](/documentation/api-and-sdk-en/integration/server-api.md)in the design section of the Developer Center.
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 CORS allowed Origins.\
The allowed Origin differs depending on the SDK version and application date.
{% hint style="info" %}
**SDK 3.x Origin change notice**
From SDK 3.x bundles uploaded after Tuesday, August 25, 2026, services will use the Origin used in SDK 2.x.\
If communicating with an external server, please add the following Origin to the server's CORS allowed Origins.
* `https://.apps.tossmini.com` : actual service environment
* `https://.private-apps.tossmini.com` : console QR test environment
{% endhint %}
| SDK version | actual 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 details, please refer to the [Mini app launch guide](/guide/en/operation/deploy.md).
Is mTLS authentication absolutely required?
Yes. mTLS authentication is required for server-to-server communication in the Apps in Toss API.
If not applied `ERR_NETWORK` an error may occur.
For details, please refer to the [API usage guide](/documentation/api-and-sdk-en/integration/server-api.md)in the design section of the Developer Center.
Are there IPs that need to be allowed in the firewall?
Yes. If you manage inbound/outbound firewalls on your server, you must allow Apps in Toss IPs.
If you do not allow them, API calls may fail, or you may not receive subscription status change callbacks, etc. to the callback URL registered in the console.
For a detailed IP and port list, [API usage guide](/documentation/api-and-sdk-en/integration/server-api.md)in the design section of the Developer Center.
Are there limits on API request counts?
Yes. The Apps 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 certain period.
If you need more requests, [Channel Talk](https://apps-in-toss.channel.io/workflows/787658)You can request a QPM increase. Please also provide the purpose of use, expected traffic volume, and peak-hour request volume.
For details, please refer to the [API usage guide](/documentation/api-and-sdk-en/integration/server-api.md)in the design section of the Developer Center.
Is there anything security-wise to check when developing a mini app?
Yes, please check the following.
* You cannot use functionality that executes code received from external sources. (e.g., `eval` etc.)
* You cannot use methods that manipulate browser history to move to your own site. (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, only encrypted `wss://` connections are used. (e.g., Firebase Firestore, Supabase Realtime, etc.)
* API communication uses only encrypted HTTPS connections.
* Sensitive information such as user login information and payment records (Toss Pay, in-app purchases) must be encrypted and stored in the DB.
* You must manage the history of user consent, such as Toss Login and terms agreement.
* We also recommend encrypting when transmitting personal information from the client to your own server.
It worked normally in the test environment, but API calls fail in the actual environment.
In the test environment (sandbox, AIT Devtools, etc.), HTTP requests are allowed, but in the live environment only HTTPS is allowed. HTTP-based APIs are blocked in the Toss app.
Please check whether the API server supports HTTPS.
For details, please refer to the [Mini app testing guide](/guide/en/operation/toss.md)in the design section of the Developer Center.
The login session is not maintained on iOS.
On iOS and iPadOS 13.4 or later, third-party cookies are completely blocked.
Please apply token-based authentication instead of cookie-based login.
For details, please refer to the [Mini app testing guide](/guide/en/operation/toss.md)in the design section of the Developer Center.
An error occurred during QR testing.
`Sentry`Connect it to check client logs for debugging.
For 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 details, please refer to 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 Unity games be launched as Apps in Toss mini apps?
Yes. If you build a Unity game to WebGL, you can make it into an Apps in Toss mini app.
If you install the Apps in Toss Unity SDK (Unity package), from WebGL build to `.ait` packaging can be handled all at once without a separate Vite project setup or JS Bridge implementation. Unity 2021.3 or later is supported.
For details, please refer to the [Unity SDK integration guide](/documentation/api-and-sdk-en/unity/integration.md)in the design section of the Developer Center.
What are the benefits of using the Apps in Toss Unity SDK?
Using the Apps in Toss Unity SDK (Unity package) offers the following benefits.
* **Short porting period**: You can port to a mini app easily and quickly without separate Vite project setup or JS Bridge implementation.
* **Improved stability and user experience**: Reduces loading time to around one-fifth.
* **Check more performance metrics**: You can check various game performance metrics such as crash rate, loading time, and FPS.
* **Pre-provided loading screen**: The loading screen is included by default in the SDK without separate setup.
There are also cases where a game that had a loading time of about 20 seconds when using manual porting, causing many user drop-offs and CS inquiries, reduced its loading time to 1 second after switching to the Unity SDK.
For details, please refer to the [Unity SDK integration guide](/documentation/api-and-sdk-en/unity/integration.md)in the design section of the Developer Center.
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 migrated WebView to SDK 3.x, you can test in a local browser using AIT Devtools. (Manual setup is required only when migrating from SDK 3.0.1.) WebView projects still using SDK 2.x must also test in the sandbox app.
For details, please refer to 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.md).
An error saying `deploymentId cannot be found` 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. In the WebView environment, the use of general web APIs is not restricted.
When is data stored in Storage deleted?
When the app is deleted, data stored in Storage is also deleted.
If you need to keep data even after app deletion or device change, please integrate with your own server.
### Release review
I don't understand the rejection reason. What exactly is the problem?
If rejected, the reason will be provided in the console, and a detailed guide for that reason can be found in the Developer Center review guidelines.
The game launch guide is [Game Launch Guide](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/checklist/app-game), and the non-game launch guide is [Non-game Launch Guide](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/checklist/app-nongame)in the design section of the Developer Center.
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 details, please refer to the mini app launch guide.
I fixed the rejected part; how do I request a re-review?
After fixing it in the console according to the rejection reason, click the 'Request re-review' button in Launch Management.
Re-review also takes 3-5 business days.
For 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: Checks whether the service can be launched as an Apps in Toss mini app. Function: Checks whether the features work so users can use the service normally. Design: Checks whether the release guide policies are violated. Security: Checks whether there is any negative impact on Apps in Toss security.
The game launch guide is [Game Launch Guide](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/checklist/app-game), and the non-game launch guide is [Non-game Launch Guide](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/checklist/app-nongame)in the design section of the Developer Center.
How long does app launch review take?
It takes 3-5 business days to complete the review. Reviews are not conducted on weekends or holidays.
For details, please refer to the mini app launch guide.
Is there a size limit for app bundle uploads?
Only app bundles up to 100 MB after unzipping can be uploaded.
For details, please refer to the mini app launch guide.
I found an error in the app after already requesting app launch review. What should I do?
Currently, app launch review requests can only be made for one bundle (version).
Cancel the review request for the bundle with the error, re-upload it, and then request review again.
For details, please refer to the mini app launch guide.
What should I do if the app launch review is rejected?
If the app launch review is rejected, you can see what needs improvement through the rejection reason.
After improving based on the rejection reason, request review again.
For 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 agent 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 a marketing tool in the console, push and alert messages are sent from the Toss app itself, so you must follow Toss's writing rules.
Please refer to the console guide for related guidance.
[Console guide for push and alert messages](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 and alerts?
Promotional messages and functional messages have different purposes, and the way they are used also differs.
Promotional messages: Messages for marketing purposes such as discounts, events, and new product announcements. You can send promotional messages to the configured segment.
Functional messages: Messages that convey essential information arising during service use, such as orders, payments, and deliveries. You can send functional messages via API.
For a more detailed guide, [Console guide for push and alert messages](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) in the design section of the Developer Center.
How many people can receive promotional pushes in one day?
Based on the workspace, up to 100,000 people can receive promotional pushes per day, and optimized delivery reaches the most appropriate users.
If the sending limit is exceeded, it resets at midnight the next day.
For details, please refer to the smart sending console guide.
How long does push message review take?
It takes 2-3 business days to complete the review.
For details, please refer to the smart sending console guide.
How do I write the notification consent text?
To send promotional notifications, you must obtain the user's consent to receive them.
The consent text must include the following, and please integrate the notification consent SDK.
Sender (partner company name)
Summary of the notification content
Guide to how to consent and withdraw consent
For sample consent text and details, please refer to the smart sending console guide.
If I set benefits tab exposure in promotions, where will it be shown?
It will be shown in list form in Toss > Benefits tab > Try out new services.
[Promotion guide to understanding](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) in the design section of the Developer Center.
Is it necessary to test promotion payouts?
You must run the promotion payout test before you can proceed with 'Get Started'.
`TEST_{promotionCode}`You must complete the test with .
For details, please refer to the promotion development guide.
Is it blocked from being paid to duplicate users in promotions?
You need to implement the duplicate payout blocking logic yourself.
Relevant details can be found [Promotion development guide](https://appsintoss.gitbook.io/appsintoss-docs/documentation/common/growth/promotion) in the design section of the Developer Center.
When will smart sending material review be completed?
Material review for sending takes 1-2 business days.
We recommend registering the material at least 3 business days before the scheduled sending date.
For details, please refer to the smart sending console guide.
I set up smart sending, but 0 items were sent.
Please check the sending target segment settings, sending time period, and the user's opt-in status.
In particular, the sending conditions for 'functional notifications' and 'promotional notifications' are different, so settings appropriate to the notification type are needed.
For details, please refer to the smart sending console guide.
When is dashboard data updated?
Dashboard data is updated around 8 AM the next day.
For details, please refer to the dashboard guide.
### Monetization
What types of ads are supported in in-app advertising?
Currently, full-screen ads and rewarded ads are supported.
Full-screen ads: The ad is displayed full screen and shown at screen transition points.
Rewarded ads: With the structure 'watch an ad to receive a reward,' users can watch ads whenever they want.
We plan to support various ad types in the future.
For details, please refer to the in-app advertising guide.
Is there an ID used for in-app ad testing?
To test in-app ads, you must use a test ID.
For test ID, [development guide for in-app advertising](https://appsintoss.gitbook.io/appsintoss-docs/documentation/common/monetization/iaa) please refer to it.
How long does it take to issue a Toss Pay Key?
After submitting the documents, it takes 7 to 14 business days.
For more details, please refer to the Toss Pay console guide.
Can approval tests be performed with a Toss Pay test Key?
The test Key can only be used to create payments.
Approval processing is not available.
For more details, please refer to the Toss Pay development guide.
Is there a price limit for in-app payments?
The price of in-app payment 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 Payments guide.
A user requested a refund. Can the partner handle it directly?
Yes, refunds can be processed individually in Console > In-App Payments > Payment History.
The refund policy is managed directly by the partner company, and users are automatically notified after processing.
For more details, please refer to the In-App Payments console guide.
eCPM keeps dropping. What could be the cause?
eCPM fluctuates depending on various factors. Please check the items below.
(1) DAU changes: If the number of users decreases, ad competition may drop and eCPM may decline.
(2) Number of ad placements: If there are too many placements, the cost per impression may decrease.
(3) Exposure frequency: Repeated exposure to the same user lowers click-through rates. (4) Ad placement: Locations that do not match the user's flow are less effective.
For details, please refer to the in-app advertising 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 configured differently.
In the live environment, delivery starts after ad placement approval is completed, and approval may 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 payments be handled?
The refund process varies depending on the app market.
Google Play: Automatically processed within 48 hours. After that, manual requests are possible. App Store: All refunds are handled directly by Apple.
For more details, please refer to the In-App Payments console guide.
### Settlement
How can I check Biz Wallet top-up funds and invoices?
Biz Wallet is a prepaid amount for running 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 on the 1~~The update is completed within 2 days. Refunds are processed after campaign end on the 1~~They are automatically reflected within 2 days.
For more details, please refer to the Understanding Settlements guide.
What is the Apps in Toss fee rate?
However, no separate fee is currently charged, and if one is introduced later, we will notify you in advance.
However, no separate fee is currently charged, and if one is introduced later, we will notify you in advance.
Please see the information below for reference.
(1) In-app ads: 15% of ad revenue is deducted as the Apps in Toss fee (2) In-app payments: 5% of the payment amount is deducted as the Apps in Toss fee (an additional 15-30% app market fee is charged separately) (3) Biz Wallet (ad push/promotions): No separate fee other than the execution cost (4) Smart Send: 9.9 KRW per item (VAT included)
For more details, please refer to the Understanding Settlements guide.
Can simplified taxpayers also receive settlements?
Yes, simplified taxpayers can also receive settlements.
However, you must issue a cash receipt instead of a tax invoice, and if it is not issued at least twice, service usage may be restricted.
Please accurately register your business type in Console > Workspace > My Info > Settlement Information.
For more details, please refer to the Understanding Settlements guide.
When and how is ad push 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 Settlements guide.
What information do I need to register to receive settlements?
To receive settlements, you must register the following items in Console > Workspace > Partner Information > Settlement Information.
Business information Bank account copy Email for tax invoice issuance
All settlements are aggregated by business entity, not by app.
For more details, please refer to the Understanding Settlements guide.
How are in-app ad settlements handled?
In-app ads are delivered through an external mediation platform or Toss Ads, and the amount paid to the partner company is the ad revenue minus the 15% Apps in Toss fee.
For more details, please refer to the Understanding Settlements guide.
How are in-app payment settlements handled?
In-app payments incur fees from both the app market (Apple, Google) and Apps in Toss.
App market fee: 15% or 30% of the supply price Toss fee: 5% of the payment amount (CBT 0%) Payment date: end of next month (business days) Settlement details provided: within 5 days of the following month
For more details, please refer to the Understanding Settlements guide.
Who issues the tax invoice?
The issuer varies depending on the settlement item.
Ad revenue (partner company → issued by Toss)
Issued directly by the partner company Issue date: the last day of the month in which revenue is generated Email: Deadline: within 2 business days each month
Apps in Toss ad fee (issued by Toss → partner company)
Toss deducts it in advance and then issues it Issue date: within 3 business days each month
In-app payment fee
Apple fee: Toss issues it on Apple's behalf Toss fee: issued by Toss
For more details, please refer to the Understanding Settlements 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 corporate joint certificate is required.
If you do not have a certificate, reverse-issued tax invoice approval is not possible, and if it is not approved, the settlement amount will be carried over to the following month. Please be sure to obtain a business certificate next month and proceed with reverse issuance approval.
For more details, please refer to the Understanding Settlements guide.
The settlement payment was not deposited / the amount is different.
Settlements are processed monthly and deposited into the registered account on the last day of the following month (for in-app ads and based on business days).
If the settlement amount was not deposited or the amount is different, please check the following:
(1) Tax invoice not approved: If you do not approve the reverse-issued tax invoice within the deadline, that month's settlement will be 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 discretionary cancellation: Cases canceled by Google/Apple are excluded from settlement.
For more details, please refer to the Understanding Settlements guide.
I want to change my settlement account. How do I do it?
You can change your settlement account in Console > Workspace > My Info > Settlement Information.
After the change, it will apply to settlements from 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 is an issue, please contact Channel Talk.
For more details, please refer to the Understanding Settlements guide.
Does changing the business type affect settlements?
Yes, if the business type (general taxpayer/simplified taxpayer/corporation) changes, the tax invoice issuance method will also change. Please contact Channel Talk about the change.
The change will be reflected from the following 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 Settlements guide.
How should Google gift card payments be handled?
Google gift card payments require a cash receipt.
After 2025.12.01, Toss will automatically issue them 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 an app market discretionary cancellation, do not cancel the cash receipt. Please refer to the settlement report provided at the beginning of the following month.
For more details, please refer to the Understanding Settlements guide.
### Promotion
How can I use the Toss logo?
The Toss logo must be used without changing its colors or proportions, in accordance with the press release guide and external advertising guide.
For more details, please refer to the press release guide.
Can the term 'listing' be used in press releases?
In press releases, use 'Toss partnership' instead of 'listing'.
And 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 send 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 finalizing 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.