> 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/zh/faq.md).

# 常见问题

{% hint style="info" %}
**请确认**

常见问题的内容可能会因运营政策改版和控制台功能更新等原因而变更。常见问题中没有的开发咨询请联系 [开发者社区](https://techchat-apps-in-toss.toss.im/)，运营咨询请联系 [ChannelTalk](https://apps-in-toss.channel.io/workflows/787658)联系。
{% endhint %}

### App in Toss 服务

<details>

<summary>App in Toss 是什么服务？</summary>

App in Toss 是一个平台，合作伙伴开发的迷你应用服务可以以“App-in-App（应用内应用）”的形式在 Toss App 内上线。

通过基于 WebView、Unity、React Native 的 SDK 可以轻松开发，也可以一并使用 Toss 设计系统（TDS）。还可以利用推送·通知和促销等进行有效营销。

</details>

<details>

<summary>App in Toss 提供哪些功能？</summary>

通过 Toss 的 SDK、API、UI 组件等，可以快速实现登录、支付、认证等核心功能。

提供从开发环境、设计、营销、变现到结算的一体化解决方案。

</details>

<details>

<summary>是否有不能以 App in Toss 迷你应用形式上线的服务？</summary>

根据 Toss 平台政策、相关法律法规和用户保护标准，部分服务会限制上线。

相关内容可在 [服务上线政策 ](/landing-page/landing-page-zh/intro/guide.md)中查看。

</details>

<details>

<summary>App in Toss 迷你应用从开发到上线需要多久？</summary>

游戏服务约需 2\~4 周，非游戏服务约需 1\~3 个月。

具体日程可能因服务类型、功能范围和审核流程而有所不同。

</details>

<details>

<summary>哪些用户可以使用 App in Toss 迷你应用服务？</summary>

App in Toss 迷你应用服务面向年满 19 岁的用户提供。

可在 Android 7 及以上或 iOS 16 及以上环境中使用。

</details>

<details>

<summary>我想在 App in Toss 上登记服务，流程是什么？</summary>

按控制台注册 → 创建工作区 → 企业注册 → 应用注册 → 请求审核的顺序进行。

可在开发者中心的“开始使用”文档中查看分步指南。

</details>

<details>

<summary>在哪里可以查看 App in Toss 网络研讨会资料？</summary>

App in Toss 网络研讨会资料可在 App in Toss 控制台和 [商务管理后台学院](https://business.toss.im/dashboard/business-academy)中查看。

</details>

### 应用注册

<details>

<summary>进行应用注册需要哪些信息？</summary>

需要填写的信息会根据是游戏服务还是非游戏服务而不同。

主要填写服务策划内容。

* 游戏：应用 logo、应用名称、appName、客户咨询邮箱、分类、评级信息、应用搜索关键词、游戏应用说明、缩略图、排行榜等
* 非游戏：应用 logo、应用名称、appName、客户咨询邮箱、分类、应用说明、应用搜索关键词等

详细内容请参考控制台中的应用注册指南。

</details>

<details>

<summary>应用注册审核需要多久？</summary>

审核完成约需 1\~2 个工作日。

详细内容请参考控制台中的应用注册指南。

</details>

<details>

<summary>appName 可以修改或删除吗？</summary>

appName 相当于应用 ID。

应用 ID 在应用信息中注册后，无法修改或删除。

详细内容请参考控制台中的应用注册指南。

</details>

<details>

<summary>游戏服务的评级审核如何申请？</summary>

要上线游戏迷你应用，需要进行“游戏分级”。

根据《游戏产业振兴相关法律》，若要以分发或服务游戏为目的进行制作·发行，必须接受分级。法律上，正式上线前未获得分级的游戏不能发布服务。

要登记评级信息，需要提供商店链接或游戏物管理委员会的文件。

在商店和游戏物管理委员会申请分级的方法是 [App in Toss 官方网站博客](https://toss.im/apps-in-toss/blog/game_rating_classification)中查看。

根据《游戏产业振兴相关法律》，若要以分发或服务游戏为目的进行制作·发行，必须接受分级。

法律上，正式上线前未获得分级的游戏不能发布服务。

要登记评级信息，需要提供商店链接或游戏物管理委员会的文件。在商店和游戏物管理委员会申请分级的方法是 [App in Toss 官方网站博客](https://toss.im/apps-in-toss/blog/game_rating_classification) 中查看。

</details>

<details>

<summary>企业注册审核需要多久？</summary>

审核完成约需 1 个工作日。

审核结果可在控制台查看。

详细内容请参考企业注册指南。

</details>

<details>

<summary>需要变更/补交营业执照，该怎么办？</summary>

可在控制台 > 设置 > 企业信息中上传营业执照。

变更时需要重新审核，约需 1\~2 个工作日。

若从个人变更为法人且企业号码不同，则需要重新创建工作区。

详细内容请参考企业注册指南。

</details>

<details>

<summary>没有企业也能上线应用吗？</summary>

没有企业也可以上线应用。

不过，如果没有企业，出于合同和结算等原因，部分功能无法使用。

需要企业才能使用的功能：Toss 登录、Biz Wallet、促销、应用内广告、Toss Pay、应用内支付

详细内容请参考企业注册指南。

</details>

### 设计

<details>

<summary>App in Toss 迷你应用设计有关于暗黑模式的政策吗？</summary>

采用超出用户预期设计的暗黑模式迷你应用不能上线。

典型的暗黑模式示例如下。

* 一进入服务就弹出底部弹窗的情况
* 按下 Back 按钮时，弹出阻止返回上一页面的底部弹窗的情况
* 没有退出功能的情况
* 在意想不到的时刻弹出广告的情况
* 看到 CTA 按钮时，无法预判自己需要做什么的情况

详细内容请参考开发者中心设计部分中的 [防止暗黑模式政策指南](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/design/consumer-ux-guide)。

</details>

<details>

<summary>什么是 TDS？</summary>

TDS 是 Toss Design System 的缩写，是 Toss 社区使用的设计系统。

TDS 是构成 Toss 产品、支持跨职能协作的设计语言，同时也是开发者的工具。

使用 TDS 能在为用户提供一致的产品体验的同时，让设计师专注于解决问题。

开发也能比自定义 UI 快 3\~5 倍完成。

相关内容可在 [开发者中心设计部分中的 Toss 设计系统指南](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/design/components) 。

</details>

<details>

<summary>使用 TDS 之前需要注意什么吗？</summary>

为安全且正确地使用 TDS，请注意以下内容。

知识产权：Toss 通过 App in Toss 服务提供的所有资料的权利均归 Toss 所有。合作伙伴只能在使用 App in Toss 服务所需的范围内使用这些资料。

使用权限：Toss 对 TDS 的使用许可，仅授予为提供 App in Toss 服务而进行的有限使用权。因此，合作伙伴无法获得超出此范围的成果物或权利。

遵守义务及违规时的措施：合作伙伴必须遵守本条款及相关法律法规。若合作伙伴违反，Toss 可停止提供 App in Toss 服务或采取其他必要措施。

详细内容请参考 Figma/TDS UI 许可指南。

</details>

<details>

<summary>什么是 App Builder？</summary>

App Builder 是面向 App in Toss 合作伙伴的 UI 设计工具。

无需额外安装，即可快速完成遵循 Toss UI 风格指南的界面。

相关内容可在 [开发者中心设计部分中的 App Builder 指南](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/design/prepare/design) 。

</details>

<details>

<summary>App in Toss 迷你应用支持系统模式下的深色模式吗？</summary>

目前 App in Toss 迷你应用不支持深色模式。

需要以浅色模式为准进行开发/设计并上线。

</details>

<details>

<summary>在哪里可以获取 Figma 资源？</summary>

可在开发者中心设计部分中的 Figma 指南里查看。

</details>

<details>

<summary>一定要使用 TDS 吗？</summary>

并非所有组件都必须用 TDS 设计。

但为了一致的用户体验，尽量建议使用 TDS；对于难以用 TDS 解决的部分，请自行开发。

详细内容请参考 Toss 设计系统指南。

</details>

<details>

<summary>可以提供 Toss Products Sans 字体吗？</summary>

Toss Products Sans 字体不单独提供。

如需应用 Toss Products Sans 字体，请使用 TDS 组件。

详细内容请参考 Toss 设计系统指南。

</details>

### 开发

<details>

<summary>我现在有正在运营的服务。如何以 App in Toss 迷你应用形式发布？</summary>

将现有服务的客户端适配到 App in Toss 环境后，可根据需要与自有后端服务器联动。

详细内容请参考 [指南](/ai-vibe-coding/zh/tutorials/webview.md)。

</details>

<details>

<summary>需要迁移到 SDK 3.x 吗？必须在什么时候之前完成？</summary>

是的，所有正在运营 WebView 和 Unity 项目的合作伙伴都必须在 2026 年 9 月 14 日之前更新到 SDK 3.x。

由于 SDK 内部处理逻辑改为服务器端，即使发生 SDK 问题，也可以直接在 App in Toss 服务器上修复并反映，无需合作伙伴重新发布。

Unity SDK 只需将 git 包更新到 3.x 版本，无需单独更改设置即可完成迁移。

详细内容请参考 [SDK 3.x 迁移指南](/documentation/api-and-sdk-zh/integration/sdk-3.x-qian-yi.md)。

</details>

<details>

<summary>导航栏需要自己实现吗？</summary>

不需要。安装 App in Toss SDK 后，默认导航栏会自动应用。

非游戏迷你应用可通过 `navigationBar` 选项自定义是否显示返回·首页按钮、背景透明化、主题（浅色/深色）、配件图标等。

详细内容请参考 [导航栏设置指南](/documentation/api-and-sdk-zh/common/navigationbar.md) 请参考。

</details>

<details>

<summary>为了开发 App in Toss，服务器是必须的吗？</summary>

不是。即使没有单独服务器，仅用 SDK 也能开发迷你应用。

只有在使用 Toss 登录、Toss Pay、智能发送等需要服务器间通信的功能时才需要自有服务器，此时再额外配置 mTLS·CORS·防火墙等服务器 API 联动设置即可。

详细内容请参考[ API 使用指南](/documentation/api-and-sdk-zh/integration/server-api.md)。

</details>

<details>

<summary>调用外部 API 时发生了 CORS 错误。</summary>

要在迷你应用中与服务器通信，需要将迷你应用 Origin 添加到服务器 CORS 允许的 Origin 中。\
需要允许的 Origin 会根据 SDK 版本和适用日期而不同。

{% hint style="info" %}
**SDK 3.x Origin 变更说明**

自 2026 年 8 月 25 日（周二）之后上传的 SDK 3.x bundle 起，将使用 SDK 2.x 中使用过的 Origin 提供服务。\
如果与外部服务器通信，请将以下 Origin 添加到服务器 CORS 允许的 Origin 中。

* `https://<appName>.apps.tossmini.com` ：实际服务环境
* `https://<appName>.private-apps.tossmini.com` ：控制台 QR 测试环境
  {% endhint %}

| SDK 版本   | 实际服务环境                                | QR 测试环境                                       |
| -------- | ------------------------------------- | --------------------------------------------- |
| 3.x      | `https://<appName>.web.tossmini.com`  | `https://<appName>.private-web.tossmini.com`  |
| 1.x\~2.x | `https://<appName>.apps.tossmini.com` | `https://<appName>.private-apps.tossmini.com` |

详细内容请参考 [迷你应用上线指南](/guide/zh/operation/deploy.md)。

</details>

<details>

<summary>mTLS 认证是必须的吗？</summary>

是的。App in Toss API 的服务器间通信要求必须使用 mTLS 认证。

如果不适用 `ERR_NETWORK` 错误可能会发生。

详细内容请参考 [API 使用指南](/documentation/api-and-sdk-zh/integration/server-api.md)。

</details>

<details>

<summary>防火墙中有需要允许的 IP 吗？</summary>

是的。如果服务器在管理 Inbound·Outbound 防火墙，务必允许 App in Toss 的 IP。

如果不允许，API 调用可能会失败，或者无法接收到注册在控制台的回调 URL 的订阅状态变更回调等。

详细 IP·端口列表请 [API 使用指南](/documentation/api-and-sdk-zh/integration/server-api.md)。

</details>

<details>

<summary>API 请求次数有限制吗？</summary>

是的。App in Toss API 以迷你应用为基准，每分钟最多可请求 3,000 次（QPM，Queries Per Minute）。

超过限额后，可能会在一段时间内阻止额外请求。

如需更多请求， [ChannelTalk](https://apps-in-toss.channel.io/workflows/787658)可申请提高 QPM。此时请一并提供使用目的、预计流量规模、峰值时段请求量。

详细内容请参考 [API 使用指南](/documentation/api-and-sdk-zh/integration/server-api.md)。

</details>

<details>

<summary>开发迷你应用时有需要从安全角度检查的内容吗？</summary>

是的，请确认以下内容。

* 不能使用从外部传入的代码执行功能。 （例如： `eval` 等）
* 不能使用通过操作浏览器历史记录将用户跳转到自家网站的方式。 （例如： `window.location.replace` 等）
* 不能使用服务器端渲染（SSR）。只能使用客户端渲染（CSR）或静态站点生成（SSG）方式。
* 如果使用 WebSocket，请仅使用加密的 `wss://` 连接。 （例如：Firebase Firestore、Supabase Realtime 等）
* API 通信仅使用加密的 HTTPS 连接。
* 用户登录信息、支付（Toss Pay、应用内支付）记录等敏感信息必须加密后存储到数据库。
* 必须管理 Toss 登录、同意条款等用户的同意记录。
* 也建议在将个人信息从客户端传输到自有服务器时进行加密。

</details>

<details>

<summary>测试环境下正常运行，但在正式环境中 API 调用失败。</summary>

测试环境（Sandbox、AIT Devtools 等）允许 HTTP 请求，但正式环境仅允许 HTTPS。基于 HTTP 的 API 会在 Toss App 中被拦截。

请确认 API 服务器是否支持 HTTPS。

详细内容请参考 [迷你应用测试指南](/guide/zh/operation/toss.md)。

</details>

<details>

<summary>iOS 上登录会话无法保持。</summary>

在 iOS·iPadOS 13.4 及以上版本中，第三方 Cookie 会被完全阻止。

请改用基于令牌的认证方式，而不是基于 Cookie 的登录。

详细内容请参考 [迷你应用测试指南](/guide/zh/operation/toss.md)。

</details>

<details>

<summary>QR 测试中发生了错误。</summary>

`Sentry`联动后查看客户端日志即可进行调试。

详细内容请参考 Sentry 设置指南。

</details>

<details>

<summary>Android Sandbox App 中出现了“打开 schema 失败”错误。</summary>

连接 Android Sandbox App 需要进行 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) 。

</details>

<details>

<summary>可以将 Unity 游戏以 App in Toss 迷你应用形式上线吗？</summary>

可以。将 Unity 游戏构建为 WebGL 后，即可制作成 App in Toss 迷你应用。

安装 App in Toss Unity SDK（Unity 包）后，无需单独配置 Vite 项目或实现 JS Bridge，即可从 WebGL 构建到 `.ait` 打包一站式处理。支持 Unity 2021.3 及以上版本。

详细内容请参考 [Unity SDK 联动指南](/documentation/api-and-sdk-zh/unity/integration.md)。

</details>

<details>

<summary>使用 App in Toss Unity SDK 有什么好处？</summary>

使用 App in Toss Unity SDK（Unity 包）有以下优势。

* **更短的移植周期**：无需单独配置 Vite 项目或实现 JS Bridge，即可轻松快速移植为迷你应用。
* **稳定性和用户体验提升**：将加载时间缩短到原来的 1/5 左右。
* **查看更多性能指标**：可查看崩溃率、加载时间、FPS 等多种游戏性能指标。
* **默认提供加载界面**：无需单独配置，加载界面已默认包含在 SDK 中。

实际案例中，手动移植方式下加载时间约 20 秒，导致用户流失和 CS 咨询增多的游戏，在切换到 Unity SDK 后加载时间缩短到 1 秒。

详细内容请参考 [Unity SDK 联动指南](/documentation/api-and-sdk-zh/unity/integration.md)。

</details>

<details>

<summary>Sandbox 测试是必须的吗？</summary>

使用 SDK 2.x 时，需要在 Sandbox App 中测试。React Native 目前仅支持 SDK 2.x，因此必须在 Sandbox App 中测试。

如果已在 WebView 中迁移到 SDK 3.x，可使用 AIT Devtools 在本地浏览器中测试。 （仅在从 SDK 3.0.1 版本迁移时需要手动设置。）仍在使用 SDK 2.x 的 WebView 项目同样需要在 Sandbox App 中测试。

详细内容请参考 [指南](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/development/test/sandbox)和 [SDK 3.x 迁移指南](/documentation/api-and-sdk-zh/integration/sdk-3.x-qian-yi.md)。

</details>

<details>

<summary>发生了“找不到 deploymentId”错误。</summary>

请按照指南 `.ait` 重新构建文件。

在构建过程中 `deploymentId`必须正确包含。

</details>

<details>

<summary>可以在 WebView 中使用 Web API 吗？</summary>

可以。WebView 环境不限制一般 Web API 的使用。

</details>

<details>

<summary>Storage 中保存的数据何时删除？</summary>

应用删除时，Storage 中保存的数据也会一并删除。

如果即使在删除应用或更换设备后也需要保留数据，请联动自有服务器。

</details>

### 上线审核

<details>

<summary>不理解驳回原因。具体是哪部分有问题？</summary>

驳回时会在控制台说明原因，关于该原因的详细指南可在开发者中心审核指南中查看。

游戏上线指南为 [游戏上线指南](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/checklist/app-game)，非游戏上线指南为 [非游戏上线指南](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/checklist/app-nongame)。

</details>

<details>

<summary>当前审核进度如何？</summary>

可在控制台 > 应用管理 > 上线管理中查看当前审核状态（受理/审核中/通过/驳回）。

详细内容请参考迷你应用上线指南。

</details>

<details>

<summary>已修改被驳回的部分，要如何申请重新审核？</summary>

在控制台根据驳回原因修改后，在上线管理中点击“申请重新审核”按钮即可。

重新审核同样需要 3\~5 个工作日。

详细内容请参考迷你应用上线指南。

</details>

<details>

<summary>应用上线审核会检查什么？</summary>

应用上线审核会审查服务、功能、设计和安全。

服务：确认是否为可作为 App in Toss 迷你应用上线的服务。功能：确认用户能否正常使用服务。设计：确认是否违反了上线指南中的政策。安全：确认是否会对 App in Toss 安全产生负面影响。

游戏上线指南为 [游戏上线指南](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/checklist/app-game)，非游戏上线指南为 [非游戏上线指南](https://appsintoss.gitbook.io/appsintoss-docs/landing-page/checklist/app-nongame)。

</details>

<details>

<summary>应用上线审核需要多久？</summary>

审核完成约需 3\~5 个工作日。周末和法定节假日不进行审核。

详细内容请参考迷你应用上线指南。

</details>

<details>

<summary>应用 bundle 上传有容量限制吗？</summary>

应用 bundle 以解压后 기준，最多只能上传 100MB 以下。

详细内容请参考迷你应用上线指南。

</details>

<details>

<summary>已经提交应用上线审核请求后，发现应用有错误，该怎么办？</summary>

目前应用上线审核请求一次只能针对 1 个 bundle（版本）进行。

取消有错误的 bundle 的审核请求，重新上传后再申请审核即可。

详细内容请参考迷你应用上线指南。

</details>

<details>

<summary>如果在应用上线审核中被驳回，该怎么办？</summary>

如果在应用上线审核中被驳回，可通过驳回原因确认需要改进的部分。

根据驳回原因完成改进后，再次申请审核即可。

详细内容请参考迷你应用上线指南。

</details>

<details>

<summary>可以咨询驳回原因吗？</summary>

可通过控制台右下角 ChannelTalk 的客服连接咨询驳回原因。

[ChannelTalk 链接](https://apps-in-toss.channel.io/user-chats/69352b8e8d373db4ee2f?page=https%3A%2F%2Fapps-in-toss.channel.io%2Fworkflows%2F787658)

</details>

### 营销

<details>

<summary>编写推送、通知文案时需要注意什么吗？</summary>

作为控制台的营销工具，推送和通知是由 Toss App 本身发送的，因此必须遵守 Toss 文案规则。

相关指南请参考控制台指南。

[推送、通知的控制台指南](https://appsintoss.gitbook.io/appsintoss-docs/guide/marketing/intro-1#%EA%B8%B0%EB%B3%B8-%EA%B7%9C%EC%B9%99)

</details>

<details>

<summary>推送、通知中广告信息和功能信息有什么区别？</summary>

广告信息和功能信息的目的不同，使用方式也不同。

广告信息：指折扣、活动、新品介绍等以营销为目的的促销消息。可以向设定的用户分群发送广告信息。

功能信息：指在服务使用过程中产生的订单、支付、配送等必要信息的消息。可以通过 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) 。

</details>

<details>

<summary>一天最多可以向多少人发送广告推送？</summary>

以工作区为基准，一天最多可向 10 万人发送广告推送，并通过优化投放触达最合适的用户。

超过发送限额后，会在次日零点重置。

详细内容请参考智能发送控制台指南。

</details>

<details>

<summary>推送消息审核需要多久？</summary>

审核完成约需 2\~3 个工作日。

详细内容请参考智能发送控制台指南。

</details>

<details>

<summary>通知接收同意文案该怎么写？</summary>

要发送广告性通知，必须获得用户的接收同意。

同意文案需包含以下内容，并请对接通知同意文 SDK。

发送主体（合作伙伴名称）

通知内容摘要

接收同意及撤回方法说明

同意文案示例和详细内容请参考智能发送控制台指南。

</details>

<details>

<summary>如果在促销中设置显示优惠标签，会显示在哪里？</summary>

会以列表形式显示在 Toss > 优惠标签 > 试用新服务中。

[促销理解指南](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) 。

</details>

<details>

<summary>促销发放测试一定要做吗？</summary>

必须完成促销发放测试，才能进行“开始使用”。

`TEST_{promotionCode}`必须使用该格式完成测试。

详细内容请参考促销开发指南。

</details>

<details>

<summary>促销中会防止重复发放给同一用户吗？</summary>

重复发放拦截逻辑需要自行实现。

相关内容可在 [促销开发指南](https://appsintoss.gitbook.io/appsintoss-docs/documentation/common/growth/promotion) 。

</details>

<details>

<summary>智能发送素材审核什么时候完成？</summary>

发送素材审核约需 1\~2 个工作日。

建议至少在预定发送日前 3 个工作日登记素材。

详细内容请参考智能发送控制台指南。

</details>

<details>

<summary>已经设置了智能发送，但发送数量为 0。</summary>

请确认发送目标分群设置、发送时间段和用户 opt-in 状态。

尤其是“功能性通知”和“广告性通知”的发送条件不同，因此需要根据通知类型进行相应设置。

详细内容请参考智能发送控制台指南。

</details>

<details>

<summary>看板中的数据何时更新？</summary>

看板中的数据会在次日上午 8 点左右更新。

详细内容请参考看板指南。

</details>

### 变现

<details>

<summary>应用内广告支持哪些类型的广告？</summary>

目前支持插屏广告和激励广告。

插屏广告：广告以全屏显示，在界面切换点展示。

激励广告：以“观看广告即可获得奖励”的结构，用户可在需要时观看广告。

今后将支持更多广告类型。

详细内容请参考应用内广告了解指南。

</details>

<details>

<summary>为了测试应用内广告，有使用的 ID 吗？</summary>

为了测试应用内广告，必须使用测试用 ID。

测试用 ID 请 [在应用内广告开发指南中](https://appsintoss.gitbook.io/appsintoss-docs/documentation/common/monetization/iaa) 查看。

</details>

<details>

<summary>Toss Pay Key 的签发需要多久？</summary>

提交资料后，需 7～14 个工作日。

详情请参考 Toss Pay 控制台指南。

</details>

<details>

<summary>可以用 Toss Pay 测试 Key 进行授权测试吗？</summary>

测试 Key 只能用于创建支付。

无法进行授权处理。

详情请参考 Toss Pay 开发指南。

</details>

<details>

<summary>应用内支付价格有上限吗？</summary>

应用内支付商品价格最低可设为 400 韩元，最高可设为 1,400,000 韩元。

详情请参考应用内支付理解指南。

</details>

<details>

<summary>用户申请退款了，合作方可以直接处理吗？</summary>

可以，在控制台 > 应用内支付 > 支付记录中可对单笔订单进行退款处理。

退款政策由合作方自行运营，处理后会自动通知用户。

详情请参考应用内支付控制台指南。

</details>

<details>

<summary>eCPM 一直在下降，原因是什么？</summary>

eCPM 会根据多种因素波动。请检查以下项目。

(1) DAU 变化：用户数减少时，广告竞争率会下降，eCPM 可能下滑。

(2) 广告位数量：广告位过多时，每次展示的单价可能会降低。

(3) 展示频率：对同一用户反复展示会降低点击率。 (4) 广告位置：与用户动线不匹配的位置效果较低。

详细内容请参考应用内广告了解指南。

</details>

<details>

<summary>广告完全不展示。测试时可以，正式环境却不行。</summary>

请确认测试 Key 和正式 Key 是否设置不同。

在正式环境中，广告位审核通过后才会开始投放，审核最多可能需要 24 小时。

也请确认广告组 ID 是否已正确匹配到该应用。

详情请参考应用内广告开发指南。

</details>

<details>

<summary>应用内支付的退款如何处理？</summary>

退款处理方式会因应用商店而异。

Google Play：48 小时内自动处理。之后可手动申请。App Store：所有退款均由 Apple 直接处理。

详情请参考应用内支付控制台指南。

</details>

### 结算

<details>

<summary>如何查看 Biz Wallet 充值金额和发票？</summary>

Biz Wallet 是用于广告推送及促销投放的预充值金额。

可在控制台 > 工作区 > Biz Wallet 中查看。充值、使用、退款记录会实时更新。发票会在次月 1~~2 日内完成更新。退款会在活动结束后 1~~2 日内自动反映。

详情请参考结算理解指南。

</details>

<details>

<summary>AppinToss 的手续费率是多少？</summary>

不过目前不会产生额外手续费，如未来产生，将提前通知。

不过目前不会产生额外手续费，如未来产生，将提前通知。

请将以下内容作为参考。

(1) 应用内广告：广告收益的 15% 作为 AppinToss 手续费扣除 (2) 应用内支付：按支付金额的 5% 作为 AppinToss 手续费扣除（另有应用商店 15\~30% 手续费） (3) Biz Wallet（广告推送/促销）：除投放费用外无额外手续费 (4) 智能发送：每笔 9.9 韩元（含 VAT）

详情请参考结算理解指南。

</details>

<details>

<summary>简易纳税人也可以进行结算吗？</summary>

可以，简易纳税人也可以进行结算。

不过需要开具现金收据代替税务发票，若未开具 2 次以上，可能会限制服务使用。

请在控制台 > 工作区 > 我的信息 > 结算信息中准确登记企业类型。

详情请参考结算理解指南。

</details>

<details>

<summary>广告推送费用何时、如何计费？</summary>

广告推送按以下方式计费。

注册时：按预计发送数量先扣除一次；实际发送后：按成功数量重新计算并退还差额

税务发票会按实际发送情况，在每月工作日 3 日内开具。

详情请参考结算理解指南。

</details>

<details>

<summary>为了进行结算，需要登记哪些信息？</summary>

为了进行结算，需要在控制台 > 工作区 > 合作方信息 > 结算信息中登记以下项目。

企业信息、交易账户副本、税务发票开具用邮箱

所有结算不是按应用，而是按企业统一汇总进行。

详情请参考结算理解指南。

</details>

<details>

<summary>应用内广告结算如何进行？</summary>

应用内广告通过外部中介平台或 Toss Ads 投放，广告收益扣除 15% 的 AppinToss 手续费后，支付给合作方。

详情请参考结算理解指南。

</details>

<details>

<summary>应用内支付结算如何进行？</summary>

应用内支付会分别产生应用商店（Apple、Google）和 AppinToss 的手续费。

应用商店手续费：按供货价的 15% 或 30% Toss 手续费：按支付金额的 5%（CBT 0%） 付款日：次月末（按工作日） 结算明细提供：次月 5 日内

详情请参考结算理解指南。

</details>

<details>

<summary>税务发票由谁开具？</summary>

开具主体会根据结算项目而不同。

广告收益（合作方 → Toss 开具）

由合作方直接开具 开具日期：收益发生月的月末 邮箱：<yj.jang@toss.im> 期限：每月工作日 2 日内

AppinToss 广告手续费（Toss → 合作方开具）

由 Toss 先行扣除后开具 开具日期：每月工作日 3 日内

应用内支付手续费

Apple 手续费：由 Toss 代开具 Toss 手续费：由 Toss 开具

详情请参考结算理解指南。

</details>

<details>

<summary>如何批准反向开具税务发票？我没有企业用公认证书。</summary>

反向开具的审批通过 Popbill 进行，需要企业用共同认证书。

如果没有认证书，本月可仅按正向开具处理；从下个月开始，必须取得企业用公认证书并进行反向开具审批。

详情请参考结算理解指南。

</details>

<details>

<summary>结算款未入账 / 金额不同。</summary>

结算按月进行，并于次月月末（应用内广告及按工作日）汇入已登记账户。

如果结算款未入账或金额不同，请检查以下内容：

(1) 税务发票未批准：若未在期限内批准反向开具税务发票，该月结算将顺延至次月。 (2) 账户信息错误：请确认户名与企业信息是否一致。 (3) 应用商店直接取消：Google/Apple 的直接取消订单会从结算中排除。

详情请参考结算理解指南。

</details>

<details>

<summary>我想更改结算账户。该怎么做？</summary>

结算账户可在控制台 > 工作区 > 我的信息 > 结算信息中更改。

更改后将从次月结算开始应用新账户。若当月结算已在进行中，可能会汇入原账户。

更改账户时，户名必须与企业信息一致。

如有问题，请通过 ChannelTalk 咨询。

详情请参考结算理解指南。

</details>

<details>

<summary>企业类型变更会影响结算吗？</summary>

会的，企业类型（一般纳税人/简易纳税人/法人）变更后，税务发票开具方式会改变。变更事项请通过 ChannelTalk 咨询。

变更将从次月结算开始反映。

如果因个人→法人变更等导致企业编号发生变化，需要重新创建工作区。

详情请参考结算理解指南。

</details>

<details>

<summary>用 Google 礼品卡支付的订单该如何处理？</summary>

Google 礼品卡支付有开具现金收据的义务。

自 2025.12.01 起由 Toss 自动代办开具。可在支付记录中确认是否为礼品卡。即使因应用商店直接取消而被排除在结算之外，也不要取消现金收据。请参考次月初提供的结算报告进行处理。

详情请参考结算理解指南。

</details>

### 宣传

<details>

<summary>如何使用 Toss 标志？</summary>

Toss 标志需按照新闻稿指南和外部广告指南使用，不得更改颜色和比例。

详情请参考新闻稿指南。

</details>

<details>

<summary>在新闻稿中可以使用“入驻”这一表述吗？</summary>

在新闻稿中应标注为“토스 제휴”，而不是“入驻”。

并且需要通过 ChannelTalk 先提交审查请求，获得批准后再发布。

详情请参考新闻稿指南。

</details>

### 服务终止

<details>

<summary>我想终止/删除应用服务。流程是怎样的？</summary>

请通过 ChannelTalk 告知应用 ID 和终止原因，运营团队会为您说明终止流程。

终止时会有现有用户通知、结算收尾等后续流程，请至少提前 2 周咨询。

详情请参考服务终止指南。

</details>


---

# 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/zh/faq.md?ask=<question>&goal=<endgoal>
```

`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.
