> 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/monetization/in-app-payment.md).

# 应用内支付

### 什么是应用内支付

应用内支付是可以在应用内直接购买付费商品的支付方式。用户无需离开应用即可支付所需的功能、道具或内容。应用内支付商品分为消耗性商品和非消耗性商品。

* **消耗性商品：** 使用后会消失的商品。若要再次使用，需要重新购买。（例如：游戏道具、金币、提示券）
* **非消耗性商品：** 购买一次后可持续使用的商品。（例如：解锁高级功能、去广告、特定内容使用权限）

<figure><img src="/files/37c9d6652f67e41ec97de10f1400c99127a349bc" alt=""><figcaption></figcaption></figure>

***

### 应用内支付的好处

* 用户无需离开应用即可直接支付，从而减少支付过程中的流失。
* 从应用上线初期就可以销售付费道具或订阅商品，快速产生收入。
* 可将消耗性商品和非消耗性商品组合起来，构建多样化的支付模式。
* 可提供符合使用目的的商品，从而进一步扩大销售额。

{% hint style="info" %}
**请注意**

* 应用内支付退款遵循 Apple 和 Google 的政策。
* 售价是供货价加上增值税（VAT）后的金额。
* 在支付进行期间，请暂停应用内功能（如音乐、视频播放等），并在支付完成后自动恢复。
  {% endhint %}

***

### 在控制台中设置

#### 1）注册商户信息

要接入应用内支付，首先需要注册商户信息。只有完成商户信息注册后，才能进行下一步的条款同意和结算信息填写。注册方法如下 [指南](https://developers-apps-in-toss.toss.im/guide/operation/register-business)。

#### 2）填写结算信息

若要结算应用内支付收入， [注册结算信息](https://developers-apps-in-toss.toss.im/guide/settlement)。请在工作区的“信息”标签中填写结算信息后提交审核。审核一般需要 2～3 个工作日。

#### 3）注册应用内商品

准确填写商品信息，可以让用户清楚了解购买内容，并减少运营中的争议和退款问题。

可注册的商品数量有限制。游戏迷你应用最多 80 个，非游戏迷你应用最多 30 个。

<figure><img src="/files/0a0d65173aa2ca55974fde0384297e593cbfc73f" alt=""><figcaption></figcaption></figure>

**商品类型**

请根据商品的使用方式选择类型。不能销售现金类、可兑换类商品，或与 Toss 积分组合提供的商品。

* 消耗品：使用后会消耗掉的商品。若要再次使用，需要重新购买。（例如：游戏道具、内部货币充值、一次性通行券）
* 非消耗品：购买一次后可持续使用的商品。（例如：去广告、收藏型内容）
* 自动续订订阅：按固定周期自动扣费，直到取消前可持续使用。（例如：月度会员、定期内容订阅）

**商品名称**

* 商品名称应如实体现用户将获得的功能和条件。
* 请按照实际提供内容填写。
* 不能使用夸张或容易引起误解的表述。例如，若使用期限已限定，就不能写“无限制”。

**商品图片**

* 请将其设计成便于用户直观理解商品的形式。
* 可以加入如“30天通行券”、“100金币”之类用于识别的文本。
* 如果加入活动性文案，必须同时标明活动期间。
* 分辨率需注册为 1024 × 1024px。
* 只能使用没有版权问题的图片，且图片需由合作方自行获取。
* 不能使用带有色情、暴力或可能引起不适的图片。

**供货价**

* 供货价是不含增值税（VAT）的金额。
* 可设置的范围为最低 400 韩元到最高 1,400,000 韩元。
* 只能以 10 韩元为单位输入。
* 输入供货价后，售价会自动计算。暂不支持先输入售价并自动计算供货价的功能。

**售价**

售价是用户实际支付的最终金额。系统会自动设置为在供货价上加上增值税后的金额。

**消耗品折扣**

可为消耗品类型的应用内商品设置折扣优惠。请在控制台的应用内商品列表中，点击展示中的消耗品商品上的“+ 折扣”按钮，登记折扣信息。设置折扣时，需要输入折扣后的供货价、折扣期间和折扣对象。完成折扣设置后无法修改。

折扣对象共有三种。

* 所有用户：不论是否有支付记录，都适用折扣。
* 无支付记录用户：适用于从未购买过的用户。
* 有支付记录用户：适用于有购买记录的用户。

<figure><img src="/files/a4385f5942fe0a432d77e97b33950cb71c9513ba" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/2450b2a63442de9bcd181e1b80509876ee67c36f" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**请注意**

* 已经购买过折扣商品的用户，即使符合折扣对象条件，也无法再获得额外折扣。
* 退款的支付也会计入购买记录。
* 折扣商品也可以通过现有的应用内支付 SDK 购买。无需单独更改 SDK 对接。
  {% endhint %}

**自动续订订阅专用设置**

选择自动续订订阅类型后，可额外设置以下项目。

* **自动续订周期：** 选择重复扣费的间隔。（每周：每 7 天 / 每月：每 30 天 / 每年：每 365 天自动扣费）
* **免费试用：** 可在一定期间内无需付款即可享受订阅权益。免费试用结束后将自动进行付费扣款。期间可选择 3 天、1 周、2 周、1 个月。
* **新订阅折扣：** 面向首次开始订阅的用户，在一定期间内以优惠价格提供。输入折扣期间和折扣供货价后，会自动计算折扣售价。
* **重新订阅折扣：** 面向之前取消订阅的用户，在重新订阅时以优惠价格提供。输入折扣期间和折扣供货价后，会自动计算折扣售价。

<figure><img src="/files/b05c5dddb19e9c47766447a99d07d565c956c546" alt=""><figcaption></figcaption></figure>

#### 4）注册支付通知 URL

当订阅续订、取消等支付状态发生变化时，可注册接收通知的 URL。注册 URL 后，状态变更时会向该 URL 发送 HTTP 请求。

* 支付通知 URL：请输入接收支付状态变更通知的服务器 URL。
* Basic Auth 头：可选输入 Basic Auth 头值。输入后，会如下包含在通知请求的 HTTP 头中。

```
Authorization: Basic {Basic Auth 头值}
```

<figure><img src="/files/396fde5eea422c3632aeaaa6f9523a9fb7590173" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/c6c9250256db76352af2cd6a1e0194d840a21b1e" alt=""><figcaption></figcaption></figure>

#### 5）查看支付与退款明细

<figure><img src="/files/77f5b758685ff81d5c7947337f398714913e76d5" alt=""><figcaption></figcaption></figure>

**支付明细**

这是用户在迷你应用中支付的商品明细。

* 支付完成：表示已向用户全部提供购买商品。
* 支付完成：表示已完成支付，但购买商品尚未发放。

**退款明细**

这是用户申请退款的记录。可以确认退款申请原因，并选择驳回或批准。通过应用内支付完成支付的用户，可在 Toss 应用中点击“申请退款”按钮发起退款申请。

退款状态如下。

* 批准退款申请：合作方已批准退款申请的记录。批准后会向应用商店提交审核请求。
* 驳回退款申请：合作方已驳回退款申请，或应用商店已驳回退款的记录。
* 退款完成：应用商店已完成退款的记录。

<figure><img src="/files/c2defbf6f4935d9b950f94ac089fcf09b4015dd8" alt=""><figcaption></figcaption></figure>

**按商店划分的退款政策**

应用内支付退款会根据用户的操作系统（OS）和商店政策而采用不同的处理方式。

<details>

<summary>Android</summary>

* 用户会直接在 Toss 应用中申请退款。
* 合作方可在 App 进 Toss 控制台的“退款明细”菜单中确认申请，并进行批准或驳回处理。
* 但最终是否批准或拒绝由 Google Play 决定。
* 退款处理结果会通过推送通知发送给用户，用户也可在订单详情页面查看。即使是合作方或 Google Play 拒绝退款的情况，也会发送同样的通知。
* 请合作方在结合内部政策和 Google Play 政策后处理退款申请。

</details>

<details>

<summary>iOS</summary>

* iOS 用户的退款由 Apple 全权管理。所有退款都由 Apple 直接判断并批准。
* 合作方不能批准或拒绝退款，因为 Apple 不向外部提供退款申请功能。
* 合作方只能通过支付状态查询 API 查看状态。

</details>

***

### 开发对接

商品列表查询、一次性支付请求等 [开发对接方法](https://developers-apps-in-toss.toss.im/documentation/api/iap#undefined)可以查看。

支付状态查询 [开发对接方法](https://developers-apps-in-toss.toss.im/documentation/api/iap)可以查看。

***

### 查看成效

可以在一个页面查看已完成开发对接的应用内支付的绩效指标。请结合销售趋势和用户支付行为一起分析，优化商品结构和运营策略。数据会从 D+1 上午 8 点后开始依次更新。

* 销售指标：总支付金额、总销售额、人均支付用户收入、每位支付用户收入
* 用户指标：活跃用户数、支付用户数、新支付用户数、复购用户数、支付率、最终转化率

<figure><img src="/files/ebc4fd66ace50c5102ad781238eff38c1c750c01" alt=""><figcaption></figcaption></figure>

***

### 常见问题

<details>

<summary>应用内支付手续费是多少？</summary>

应用内支付手续费适用 App 商店手续费 15%（未来可能会随收入变化）+ Toss 手续费 5%。

详情请查看 结算了解 > 应用内支付 项目。

</details>

<details>

<summary>我想测试应用内支付。</summary>

应用内支付可在沙盒环境中测试。请查看指南。

</details>

<details>

<summary>如果用户希望退款，该怎么办？</summary>

iOS 用户请引导至 Apple 客服。（权限全部归 Apple 所有。）

Android 用户请按照指南，引导其在 Toss 应用内申请退款。

</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/monetization/in-app-payment.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.