> 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/)，运营咨询请联系 [Channel Talk](https://apps-in-toss.channel.io/workflows/787658)进行咨询。
{% endhint %}

### Apps in Toss 服务

<details>

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

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

通过基于 WebView、Unity、React Native 的 SDK 可以轻松开发，也可以同时利用 Toss 设计系统（TDS）。还可以借助推送·通知和促销等开展高效营销。

</details>

<details>

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

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

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

</details>

<details>

<summary>有不能以 Apps in Toss 迷你应用形式开放的服务吗？</summary>

根据 Toss 平台政策、相关法律法规和用户保护标准，有些服务会限制开放。

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

</details>

<details>

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

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

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

</details>

<details>

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

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

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

</details>

<details>

<summary>我想把服务注册到 Apps in Toss，流程是怎样的？</summary>

按照 控制台注册 → 创建工作区 → 企业登记 → 应用注册 → 提交审核 的顺序进行。

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

</details>

<details>

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

Apps in Toss 研讨会资料可在 Apps in Toss 控制台和 [Business Admin Academy](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>

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

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

注册等级信息需要商店链接或游戏物管理委员会的文件。

关于如何在商店和游戏物管理委员会获得等级分类的方法，请参考 [Apps in Toss 官方网站的博客](https://toss.im/apps-in-toss/blog/game_rating_classification)中查看。

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

依法，正式上线前未取得等级的游戏不能发布服务。

注册等级信息需要商店链接或游戏物管理委员会的文件。关于如何在商店和游戏物管理委员会获得等级分类的方法，请参考 [Apps 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>Apps 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 通过 Apps in Toss 服务提供的所有资料的权利均归 Toss 所有。合作伙伴公司只能在仅用于使用 Apps in Toss 服务的范围内使用该资料。

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

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

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

</details>

<details>

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

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

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

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

</details>

<details>

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

目前 Apps 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>目前有正在运营的服务。如何发布为 Apps in Toss 迷你应用？</summary>

先按照 Apps 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 问题，也可以直接在 Apps in Toss 服务器上修复并反映，无需合作伙伴公司的重新发布。

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

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

</details>

<details>

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

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

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

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

</details>

<details>

<summary>开发 Apps 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>

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

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

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

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

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

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

</details>

<details>

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

有。如果服务器中管理着 Inbound·Outbound 防火墙，则必须允许 Apps in Toss IP。

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

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

</details>

<details>

<summary>API 调用次数有限制吗？</summary>

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

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

如果需要更多请求， [Channel Talk](https://apps-in-toss.channel.io/workflows/787658)可以通过 Channel Talk 请求提高 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、应用内支付）记录等敏感信息必须加密后存储在 DB 中。
* Toss 登录、条款同意等用户的同意记录必须管理。
* 即使将个人信息从客户端发送到自有服务器，也建议加密。

</details>

<details>

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

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

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

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

</details>

<details>

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

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

请改用基于 Token 的认证方式，而不要使用基于 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 游戏以 Apps in Toss 迷你应用的形式上线吗？</summary>

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

安装 Apps in Toss Unity SDK（Unity package）后，无需单独配置 Vite 项目或实现 JS Bridge，从 WebGL 构建到 `.ait` 打包可以一次性完成。支持 Unity 2021.3 及以上版本。

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

</details>

<details>

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

使用 Apps in Toss Unity SDK（Unity package）有以下好处。

* **较短的移植周期**：无需单独配置 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>沙箱测试是必须的吗？</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.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>

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

服务：确认是否可以作为 Apps in Toss 迷你应用上线。功能：确认功能是否正常运行，以便用户正常使用服务。设计：确认是否违反上线指南中的政策。安全：确认是否对 Apps 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>

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

[Channel Talk 链接](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>Apps in Toss 的手续费率是多少？</summary>

不过目前不会产生额外手续费，若日后产生，我们会提前通知。

不过目前不会产生额外手续费，若日后产生，我们会提前通知。

以下内容仅供参考。

(1) 应用内广告：广告收益的 15% 作为 Apps in Toss 手续费扣除 (2) 应用内支付：按支付金额的 5% 作为 Apps in Toss 手续费扣除（另收应用商店手续费 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 投放，广告收益扣除 Apps in Toss 15% 手续费后的金额会支付给合作方。

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

</details>

<details>

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

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

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

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

</details>

<details>

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

根据结算项目不同，开具主体也不同。

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

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

Apps in Toss 广告手续费（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>

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

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

变更账户时，账户名必须与经营主体信息一致。

如有问题，请通过 Channel Talk 咨询。

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

</details>

<details>

<summary>经营主体类型变更后会影响结算吗？</summary>

是的，若经营主体类型（一般纳税人/简易纳税人/法人）变更，税务发票的开具方式也会不同。变更事项请通过 Channel Talk 咨询。

变更事项会从次月结算起反映。

若因个人→法人变更等导致营业执照号码发生变化，则需要重新创建工作区。

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

</details>

<details>

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

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

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

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

</details>

### 宣传

<details>

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

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

详情请参考新闻稿指南。

</details>

<details>

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

在新闻稿中应写作“Toss 合作”，而不是“入驻”。

并且需要通过 Channel Talk 咨询先请求审核，获得批准后再发布。

详情请参考新闻稿指南。

</details>

### 服务终止

<details>

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

通过 Channel Talk 告知应用 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.
