---
title: 增值服务方案 - 概览
summary: 涂鸦为 App 提供的增值服务商业化能力：分成模式由涂鸦代收用户款项并向开发者分成；核销模式由开发者向涂鸦采购额度、用户走自有收款并在履约时核销；开放接口需工单对接；提供基于 Ray 的 C 端购买与履约模板。
---

<h2 id="增值服务方案" class="nx-font-semibold nx-tracking-tight nx-text-slate-900 dark:nx-text-slate-100 nx-mt-10 nx-border-b nx-pb-1 nx-text-3xl nx-border-neutral-200/70 contrast-more:nx-border-neutral-400 dark:nx-border-primary-100/10 contrast-more:dark:nx-border-neutral-400">增值服务方案<span className="tag_h2">商业化</span></h2>

本文说明**增值服务**在 APP 内的**售卖与履约**怎么落地：适合谁、平台提供什么、两种常见结算方式的区别，以及如何接入模板与接口。

### 适用场景

在智能小程序等场景中，若你需要：

- **付费后才能用的能力或内容**（订阅、解锁等），并希望有相对完整的购买与履约流程。
- 按与涂鸦约定的模式完成**分成**或**核销结算**，又不想从零搭建整条支付与对账链路。

可考虑使用平台提供的增值服务方案，降低自建成本。

### 平台提供什么

平台侧覆盖 **创建服务 → 用户购买 → 履约（开通/使用）** 的闭环；你主要关注商品配置、收款/结算模式以及与开放接口的对接方式。

### 两种结算模式（分成 / 核销）

| 模式     | 一句话                                                                                               | 典型流程                                                       |
| -------- | ---------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
| **分成** | 用户付钱给**涂鸦代收**，涂鸦再按约定给服务售卖方（你）分成。                                         | 收款、分账规则以涂鸦侧流程与协议为准；你侧重商品与履约。       |
| **核销** | 服务售卖方（你）**向涂鸦采购服务额度**；用户在**你自己的收款渠道**付款；履约时与涂鸦**按额度核销**。 | 用户侧收款走你方；与涂鸦侧按额度结算，需按商务约定采购与核销。 |

两种模式的**商品配置、签约、计费细则**以涂鸦增值服务及商务/交付文档为准；上线前务必与对接同学对齐。

### 开发者对接（开放接口）

与增值服务相关的**对外开放接口**不对外公开自助文档，需通过 **工单** 申请评估与正式对接；请勿在未获授权时按猜测自行联调生产接口。

- **工单入口**：[涂鸦服务台](https://service.console.tuya.com/8/3/list?source=support_center)

### C 端小程序模板

模板用于快速搭建**付费墙 / 应用内购买**类页面，能力包括：

- 商品与 SKU 展示
- Apple / Google 应用内购买（IAP）
- PayPal、Stripe、支付宝、微信等第三方支付（按实际开通情况）
- 内置 **Mock**：无后端或未下发文案时，可在本地模拟购买流程，便于开发与演示

**模板入口**：[服务购买模板（ServicePurchase）](https://developer.tuya.com/material/library_hKiOVClc/component?code=ServicePurchase)

**界面示例**：

<Image style={{ margin: '20px 0', width: '300px' }} src="/images/solution/purchase/purchase-zh-1.jpg" />
<Image style={{ margin: '20px 0', width: '300px' }} src="/images/solution/purchase/purchase-zh-2.jpg" />

#### 使用前准备

- 已注册涂鸦开发者账号，已创建小程序应用并拿到 **miniAppId**
- 已在平台开通**应用内购买**等相关能力
- 若要做真机支付联调，需熟悉 Apple IAP、Google Play 的上架与支付配置（各商店规则以官方为准）

#### 接真实环境前必改项

在 `src/constants/index.ts` 中：

| 常量            | 说明                                                                                  |
| --------------- | ------------------------------------------------------------------------------------- |
| `CATEGORY_CODE` | 商品目录编码。默认 `"MOCK_CATEGORY_CODE"` 表示 **Mock**：走本地假数据，不接真实商品。 |
| `miniAppId`     | 你的小程序 ID                                                                         |

将 `src/utils/fetch/api.ts` 里占位符 `<HIGHWAY-PLACEHOLDER-*>` 替换为工单/对接方提供的**真实开放接口名**。

若暂时没有 **CATEGORY_CODE** 或 **API 授权**，可通过 **[技术支持 / 工单](https://service.console.tuya.com/8/3/list?source=support_center)** 申请。

#### 模板内主要页面

| 路径                      | 用途                           |
| ------------------------- | ------------------------------ |
| `/pages/home/index`       | 权益或落地页，可跳转到商品页   |
| `/pages/product-v1/index` | 商品页样式一（偏服务信息展示） |
| `/pages/product-v2/index` | 商品页样式二（偏 SKU 与购买）  |
| `/pages/payment/index`    | 支付 WebView 或 Mock 支付页    |

### 案例

详情请查看案例页：[充值订阅](../case#四充值订阅)