---
title: 增值服务方案 - 概览
summary: 涂鸦为 OEM App 提供的增值服务核销能力：覆盖网易云音乐核销的签约采购、OEM 商城开通、库存管理、订阅商品配置与 C 端对接；开放接口需工单；提供基于 Ray 的购买与履约模板。
---

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

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

针对 **OEM App 接入虚拟服务**，给出从商务签约、开通自有商城、额度采购，到商城订阅商品配置、渠道投放与 C 端对接的完整配置路径。

### 适用场景

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

- **付费后才能用的能力或内容**（订阅、解锁等），并希望有相对完整的购买与履约流程。
- 在 **OEM App** 内销售增值服务（下文以“网易云音乐”为例），自行收款、向涂鸦采购额度并按**核销**履约。

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

### 平台提供什么

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

### 核销结算模式

| 模式     | 一句话                                                                                               | 典型流程                                                       | 常见投放场景                             |
| -------- | ---------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | ---------------------------------------- |
| **核销** | 服务售卖方（你）**向涂鸦采购服务额度**；用户在**你自己的收款渠道**付款；履约时与涂鸦**按额度核销**。 | 用户侧收款走你方；与涂鸦侧按额度结算，需按商务约定采购与核销。 | **OEM App + OEM 自有商城**，**核销**投放 |

商品配置、签约、计费细则以涂鸦增值服务及商务/交付文档为准；上线前务必与商务对齐。

---

### 接入流程与配置

以 **“网易云音乐”** 为例，在 OEM 场景下通常同时涉及两层能力：

1. **设备侧播放授权**：产品开通「AI 播放网易云音乐」高级功能，并在交付物采购时带上授权（详见智能体 [音乐故事技能](https://developer.tuya.com/cn/docs/iot/music_tool?id=Keziqxnjdvn6c)）。
2. **C 端增值服务售卖与核销**：在 OEM 商城配置订阅 / 体验商品，用户在 OEM App 付款后履约开通服务凭证，并与涂鸦按额度核销。

下文按配置顺序给出完整链路；**务必先完成服务与额度，再投放渠道**，否则履约时可能找不到服务。

#### 服务编码对照

以 **“网易云音乐”** 核销接入为例，配置商城商品、产品服务关联，以及 C 端获取商品和服务凭证，使用下列编码：

| 编码类型          | 字段           | 取值示例                                      | 使用位置                                              |
| ----------------- | -------------- | --------------------------------------------- | ----------------------------------------------------- |
| **服务大类 code** | `catalogCode`  | `AI_COMPANION`（AI陪伴）                      | 签约、商城「产品服务」关联、C 端查询商品和服务 等入参 |
| **对接能力 code** | `externalCode` | `vas_ai_companion_fgv5zu5v2csg`（网易云音乐） | 商城「产品服务」中各套餐绑定的履约服务项              |

说明：

- 签约入口与服务大类一致：[`https://www.tuya.com/vas/commodity/AI_COMPANION`](https://www.tuya.com/vas/commodity/AI_COMPANION)。
- C 端拉商品、查凭证时传 **`catalogCode: "AI_COMPANION"`**；凭证 / 能力明细里应对齐对接能力 code **`vas_ai_companion_fgv5zu5v2csg`**。
- 其他增值服务请替换为对接方下发的大类与能力 code，勿混用本表示例值。

```mermaid
flowchart TD
  A[1. 商务签约与物料准备] --> B[2. 开通 OEM 商城与店铺]
  B --> C[3. 核销签约与额度采购]
  C --> D[4. 配置虚拟产品与订阅计划]
  D --> E[5. 产品关联履约服务]
  E --> F[6. 核销模式渠道投放]
  F --> G[7. OEM App / 小程序售卖对接]
  G --> H[8. 设备侧能力与会员绑定]
  H --> I[9. 凭证查询与对账]
```

#### 1. 商务签约与物料准备

与涂鸦商务 / 交付对齐并完成：

- 确认结算模式为 **核销**（OEM 自有商城销售）。
- 完成核销相关增值服务签约 / 采购入口：[AI Companion 增值服务商品页](https://www.tuya.com/vas/commodity/AI_COMPANION)（服务大类 code：`AI_COMPANION`；按页面指引完成签约与能力采购；具体 SKU / 计费以页面与商务确认为准）。
- 明确网易云音乐 **服务大类 `AI_COMPANION`**、**对接能力 `vas_ai_companion_fgv5zu5v2csg`**（见上文编码对照），以及计费与履约规则（周期型订阅为主）。
- 申请交易入账所需的 **物料编号**，并按交付要求加入收入入账协同流程（月初账单确认等）。
- 确认数据中心范围：网易云音乐能力当前以**中国数据中心**为主；商城站点需按目标用户所在数据中心配置（各数据中心对应国家站点承接该中心下全部国家用户，而非仅该国用户）。

若编码或接口授权有疑问，通过 **[技术支持 / 工单](https://service.console.tuya.com/8/3/list?source=support_center)** 确认。

#### 2. 开通 OEM 商城与店铺

OEM 客户需购买并开通自有商城，再在商家后台完成店铺与站点准备：

1. 在商城套餐页开通 OEM 商城：[商城开通 / 套餐定价](https://mall.tuya.com/?#packagesPricing)。
2. 开通完成后，登录商家后台（Tuya Smart Developer Center / 商城商家后台）。
3. 进入**已开通的 OEM 商城**空间。
4. 按业务切换目标**数据中心**，并选择对应**国家站点 / 店铺**进行配置。
5. 确认店铺支付能力：按需开通微信 / 支付宝 / Apple IAP / Google IAP 等（以 OEM App 实际上架与商务开通结果为准）。

#### 3. 核销签约与额度采购

核销模式要求客户先具备可扣减的服务库存额度（库存维度一般为：商家 IoT 账号 + 服务大类 + 服务项；充值后方可在 OEM App 售卖）。

1. 若尚未完成签约，先通过 [AI Companion 增值服务商品页](https://www.tuya.com/vas/commodity/AI_COMPANION) 完成核销相关签约 / 采购（可按需选择服务 SKU、购买数量并提交报价申请）：

<Image style={{ margin: '20px 0', width: '100%', maxWidth: '1000px' }} src="https://images.tuyaus.com/smart/miniapp/static/bay1601296104948oVog/178575788631f13d8c26f.png" />

2. 按商务合同采购网易云（或对应服务大类）的**核销库存额度**。
3. 由涂鸦侧完成额度管控与充值（充值时需标注客户服务凭证 / 合同信息，便于对账）。
4. 额度不足时，用户侧可能下单失败或履约失败；上线前与运营确认额度水位与预警。

采购与充值完成后，可在以下入口查看库存与变更明细：

| 入口路径                        | 说明                                                                                           |
| ------------------------------- | ---------------------------------------------------------------------------------------------- |
| VAS → 我的订单 → **库存管理**   | 查看库存；点击后会跳转到 IoT 相关页面。[库存管理入口](https://www.tuya.com/vas/user/bulkStock) |
| IoT 平台 → **增值服务库存管理** | 查看库存及变更记录。[库存变更记录](https://platform.tuya.com/cost/bulkStockRecords)            |

VAS 侧入口示意（个人中心 → 我的订单 → 库存管理 → 点击跳转）：

<Image style={{ margin: '20px 0', width: '100%', maxWidth: '1000px' }} src="https://images.tuyaus.com/smart/miniapp/static/bay1601296104948oVog/1785757886f52723140e2.png" />

IoT 平台「增值服务库存管理」示意（可查询购入 / 使用明细与库存水位）：

<Image style={{ margin: '20px 0', width: '100%', maxWidth: '1000px' }} src="https://images.tuyaus.com/smart/miniapp/static/bay1601296104948oVog/17857578869c4a4983eb9.png" />

建议日常以以上入口核对采购、充值与扣减明细；上线前对齐库存水位，履约异常时优先核对是否库存不足或未充值到对应服务大类 / 服务项。

#### 4. 配置虚拟产品与订阅计划

在 OEM 商城店铺中配置可售虚拟商品（网易云音乐月卡 / 年卡 / 体验包等）。下列截图来自商城商家后台配置流程，请在**自有 OEM 商城**中操作。

##### 4.1 新建虚拟产品

1. 进入「商品 → 商品库」，点击 **新建商品**。

<Image style={{ margin: '20px 0', width: '100%', maxWidth: '1000px' }} src="https://images.tuyaus.com/smart/miniapp/static/bay1601296104948oVog/1785757886d3930ad876d.png" />

2. 若存在月套餐、年套餐等多个规格，建议勾选**多规格**；**取消**「这是实物产品」（勾选会导致结账要求收货地址）。

<Image style={{ margin: '20px 0', width: '100%', maxWidth: '1000px' }} src="https://images.tuyaus.com/smart/miniapp/static/bay1601296104948oVog/1785757886013a244b784.png" />

3. 建议勾选「库存为 0 时继续销售」，避免 App 端因库存不足交易失败。

<Image style={{ margin: '20px 0', width: '100%', maxWidth: '1000px' }} src="https://images.tuyaus.com/smart/miniapp/static/bay1601296104948oVog/1785757886c8d134dbd2b.png" />

4. 配置多规格（如月订阅 / 年订阅）。**单规格与多规格不可互转**；后续若要多规格，只能新建产品。

<Image style={{ margin: '20px 0', width: '100%', maxWidth: '1000px' }} src="https://images.tuyaus.com/smart/miniapp/static/bay1601296104948oVog/1785757886a959f20dc29.png" />

5. 完善描述后保存并上架。

<Image style={{ margin: '20px 0', width: '100%', maxWidth: '1000px' }} src="https://images.tuyaus.com/smart/miniapp/static/bay1601296104948oVog/1785757886a71f48fc690.png" />

##### 4.2 配置产品计划

| 支付类型     | 含义                                           | 网易云常见用法               |
| ------------ | ---------------------------------------------- | ---------------------------- |
| **普通支付** | 一次性付款，支付后立即得权益，不自动续费       | 7 天体验、加油包、不续期会员 |
| **订阅支付** | 按周期付款，期内可用，到期自动续费，可随时取消 | 月套餐、年套餐等连续订阅     |

在「订阅充值 → 产品计划」中为商品新增计划。仅单次购买时，不必开启「以订阅方式销售」；为各规格填写价格，并按需填入 Apple IAP / Google IAP Product ID：

<Image style={{ margin: '20px 0', width: '100%', maxWidth: '1000px' }} src="https://images.tuyaus.com/smart/miniapp/static/bay1601296104948oVog/1785757886795c120f7a9.png" />

需要自动续费时，打开「支持你的商品以一个订阅方式销售」，新建周期计划（计划类型、下单周期、试用 / 折扣等）：

<Image style={{ margin: '20px 0', width: '100%', maxWidth: '1000px' }} src="https://images.tuyaus.com/smart/miniapp/static/bay1601296104948oVog/1785757886016aa96ac74.png" />

月套餐示例：下单周期与履约周期保持一致（如 30 天）；首购折扣 / 试用与 Apple、Google 侧优惠保持一致：

<Image style={{ margin: '20px 0', width: '100%', maxWidth: '1000px' }} src="https://images.tuyaus.com/smart/miniapp/static/bay1601296104948oVog/17857578862bde1a78396.png" />

计划列表示意（如月套餐 + 年套餐）：

<Image style={{ margin: '20px 0', width: '100%', maxWidth: '1000px' }} src="https://images.tuyaus.com/smart/miniapp/static/bay1601296104948oVog/17857578864ae25ab942c.png" />

其他配置要点：

- 希望「试用结束后自动扣费续期」：使用订阅计划内的**提供试用**，不要用普通支付做「假试用」。
- 订阅扣费一般会**提前 1～2 个自然日**，避免服务中断。
- 若作用对象是**设备或家庭**：计划中务必勾选对应信息，结账时会让用户选择家庭 / 设备；若不希望用户手选，可在跳转商品详情 URL 后拼接 `uuid`、`devId` 等参数，系统优先使用链接参数。
- 强制走 IAP 的场景：未填 Apple / Google IAP 的选项可能在客户端被过滤不可见（需补齐 IAP 或按交付要求调整）：

<Image style={{ margin: '20px 0', width: '100%', maxWidth: '1000px' }} src="https://images.tuyaus.com/smart/miniapp/static/bay1601296104948oVog/17857578869fabf7e3881.png" />

- 将定价同步到所需支付渠道（Paypal / Stripe / Apple IAP / Google IAP 等）后再上架验证：

<Image style={{ margin: '20px 0', width: '100%', maxWidth: '1000px' }} src="https://images.tuyaus.com/smart/miniapp/static/bay1601296104948oVog/178575788738dfdebe952.png" />

配置结果示例（可按业务裁剪）：

- 普通支付「7 天体验」：支付后开通 7 天权益，到期关闭（不自动续）。
- 订阅「月套餐」：周期 30 天，到期前自动扣费并生成新服务单。
- 订阅「年套餐」：周期 365 天，到期前自动扣费并生成新服务单。

##### 4.3 Apple / Google IAP

若 OEM App 在 iOS / Android 商店售卖订阅：

- **Apple**：App Store Connect 创建订阅组与订阅项（或非续期订阅）；Product ID 回填商城计划；涂鸦 AM 商品流程当前不支持同组订阅升降级，勿配升降级策略；购买项须为「已批准」状态。
- **Google**：按「订阅 → 基础方案 → 优惠」结构配置；订阅 ID / 基础方案周期与商城计划对齐并激活。

Apple 侧关键界面示意：

<Image style={{ margin: '20px 0', width: '100%', maxWidth: '1000px' }} src="https://images.tuyaus.com/smart/miniapp/static/bay1601296104948oVog/1785757886739e763f572.png" />

<Image style={{ margin: '20px 0', width: '100%', maxWidth: '1000px' }} src="https://images.tuyaus.com/smart/miniapp/static/bay1601296104948oVog/17857578867a7b8c43edd.png" />

<Image style={{ margin: '20px 0', width: '100%', maxWidth: '1000px' }} src="https://images.tuyaus.com/smart/miniapp/static/bay1601296104948oVog/178575788648e8afe755e.png" />

商店侧细则以 Apple / Google 官方文档及交付 checklist 为准。

#### 5. 产品关联履约服务

商品展示与支付配置完成后，必须配置「产品服务」，否则用户付款后不知道开通哪项能力：

1. 在「订阅充值 → 产品服务」中，对目标商品点击 **管理服务**。

<Image style={{ margin: '20px 0', width: '100%', maxWidth: '1000px' }} src="https://images.tuyaus.com/smart/miniapp/static/bay1601296104948oVog/17857578864bcbc76fcdc.png" />

2. 选择产品关联的**服务大类**（网易云对应大类 / catalogCode），并为各套餐配置**履约服务**与**单次周期**。

<Image style={{ margin: '20px 0', width: '100%', maxWidth: '1000px' }} src="https://images.tuyaus.com/smart/miniapp/static/bay1601296104948oVog/178575788684ede447027.png" />

<Image style={{ margin: '20px 0', width: '100%', maxWidth: '1000px' }} src="https://images.tuyaus.com/smart/miniapp/static/bay1601296104948oVog/17857578860b62f3b5b9d.png" />

3. **再次确认**：履约周期 = 计划扣款周期（例如月订阅 → 30 天，年订阅 → 365 天）。

#### 6. 渠道投放

顺序固定：**先关联服务，再投放渠道**。

| 项目     | OEM 核销建议                                                                 |
| -------- | ---------------------------------------------------------------------------- |
| 投放模式 | 选择 **核销模式**（客户自有 OEM 商城在 OEM App 内销售）                      |
| 投放渠道 | 支持小程序、面板等（以当前平台能力为准）                                     |
| 用户范围 | 可按需圈定 App 内部分用户                                                    |
| 商品标签 | 可为商品打标签，便于 `getVasSpuList` 等接口按 `bindingTags` 过滤同大类下商品 |

OEM 核销投放入口：销售渠道 → **OEM App 渠道** → 小程序 / 设备面板，添加商品生效范围：

<Image style={{ margin: '20px 0', width: '100%', maxWidth: '1000px' }} src="https://images.tuyaus.com/smart/miniapp/static/bay1601296104948oVog/17857578867e094b2d82b.png" />

设备面板投放时可绑定 PID、商品、标签，并圈定生效 App：

<Image style={{ margin: '20px 0', width: '100%', maxWidth: '1000px' }} src="https://images.tuyaus.com/smart/miniapp/static/bay1601296104948oVog/17857578860850832da73.png" />

商品标签配置示意：

<Image style={{ margin: '20px 0', width: '100%', maxWidth: '1000px' }} src="https://images.tuyaus.com/smart/miniapp/static/bay1601296104948oVog/1785757886f659cbf4aec.png" />

#### 7. 售卖对接

商城与投放就绪后，在 OEM App 或面板 / 业务小程序中对接售卖与权益判断：

##### 方案一：跳转通用购买页面

调用 [`getVasSpuList`](https://developer.tuya.com/cn/miniapp/develop/ray/api/vas/getVasSpuList) 获取商品基础信息与 `commodityUrl`，跳转通用购买页完成下单。

入参重点：`catalogCode`、`bindingObjectType`（APP / PID / 小程序）、`bindingObjectCode`、`bindingTags`（若有）、`needSkuList`、`clientInfo.appScheme`。

##### 方案二：自定义购买流程

1. **查询商城信息** - [`getMallInfoV2`](https://developer.tuya.com/cn/miniapp/develop/ray/api/vas/getMallInfoV2)
2. **查询 SKU 列表** - [`getSkuListV2`](https://developer.tuya.com/cn/miniapp/develop/ray/api/vas/getSkuListV2)
3. **查询支付信息** - [`getSkuPayment`](https://developer.tuya.com/cn/miniapp/develop/ray/api/vas/getSkuPayment)
4. **创建订单** - [`createOrderV2`](https://developer.tuya.com/cn/miniapp/develop/ray/api/vas/createOrderV2)
5. **发起预支付** - [`getPrepay`](https://developer.tuya.com/cn/miniapp/develop/ray/api/vas/getPrepay)

`getPrepay` 按履约对象传联系信息：家庭级 `code: '3'`（groupId 等），设备级 `code: '4'`（devId / uuid 等）。

##### 查询用户凭证

调用 [`getCredentialList`](https://developer.tuya.com/cn/miniapp/develop/ray/api/vas/getCredentialList)，用 `catalogCode` 判断是否已开通，并关注 `effectiveEndDate`、`quotaUsage.leftQuantity` 等。

> 核销模式下，用户在你方渠道付款后，需按对接方提供的履约 / 核销开放能力完成额度扣减与凭证开通；部分开放接口不对外自助公开，需通过工单申请后再联调，请勿猜测生产接口。

#### 9. 设备侧能力与会员内容

仅完成商城售卖不够，设备要调用该能力还须：

1. 产品开发中开通 **AI 播放网易云音乐**，并在开通状态下采购交付物（授权随设备；未开通即采购则设备无授权）。
2. 智能体添加「音乐故事技能」并投放至该 PID。
3. 面板可调用 [`getPanelAgentConfigNetEaseCloudMusic`](https://developer.tuya.com/cn/miniapp/develop/ray/api/ai/panelAgent/getPanelAgentConfigNetEaseCloudMusic) 查询 `supportEnableNetEaseCloudMusic` / `enableNetEaseCloudMusic`。
4. 播放会员曲库：设备所有者在中国区面板「第三方内容授权」绑定网易账号（需厂家已购高级能力）。

#### 10. 上线检查清单

| 序号 | 检查项                                                                                                                                              | 通过标准                         |
| ---- | --------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| 1    | 核销签约（[AI Companion](https://www.tuya.com/vas/commodity/AI_COMPANION)）、物料编号、catalogCode                                                  | 商务 / 运营确认                  |
| 2    | OEM 商城已开通（[套餐定价](https://mall.tuya.com/?#packagesPricing)）、正确数据中心与站点店铺                                                       | 可登录并可建品                   |
| 3    | 核销额度已充值；可在 [VAS 库存管理](https://www.tuya.com/vas/user/bulkStock) / [IoT 库存记录](https://platform.tuya.com/cost/bulkStockRecords) 核对 | 额度水位充足、流水可查           |
| 4    | 服务大类 / 能力已配置                                                                                                                               | 与商品履约一致                   |
| 5    | 虚拟产品 + 计划（订阅周期 / IAP ID）                                                                                                                | 与商店侧一致；非实物             |
| 6    | 产品服务已关联且周期匹配                                                                                                                            | 先服务后投放                     |
| 7    | 渠道投放为核销，且绑定 OEM App / 小程序 / 面板                                                                                                      | 接口可按绑定对象拉到商品         |
| 8    | App / 小程序云能力已授权，CATEGORY_CODE 已替换                                                                                                      | 真机可拉品、可下单或可跳转购买页 |
| 9    | PID 高级功能 + 交付物授权 + 智能体音乐工具                                                                                                          | 设备可播非会员资源               |
| 10   | 凭证查询 / 临期提醒 / 对账流程                                                                                                                      | 运营与财务可用                   |

---

### 自定义购买流程开发模板

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

- 商品与 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="https://images.tuyaus.com/smart/miniapp/static/bay1601296104948oVog/1785810286809284b940f.jpg" />
<Image style={{ margin: '20px 0', width: '300px' }} src="https://images.tuyaus.com/smart/miniapp/static/bay1601296104948oVog/17858102850e041b021a0.jpg" />

#### 使用前准备

- 已注册涂鸦开发者账号，已创建小程序应用并拿到 **miniAppId**
- 已按上文完成 **OEM 商城建品 / 核销投放**（或对接方提供的测试商品）
- 已在平台开通**应用内购买**等相关能力
- 若要做真机支付联调，需熟悉 Apple IAP、Google Play 的上架与支付配置（各商店规则以官方为准）

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

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

| 常量            | 说明                                                                                                         |
| --------------- | ------------------------------------------------------------------------------------------------------------ |
| `CATEGORY_CODE` | 商品目录编码。默认 `"MOCK_CATEGORY_CODE"` 表示 **Mock**：走本地假数据；网易云真实环境填 **`AI_COMPANION`**。 |
| `miniAppId`     | 你的小程序 ID                                                                                                |

若暂时没有 **CATEGORY_CODE** 可通过 **[技术支持 / 工单](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#四充值订阅)