增值服务方案商业化
本文说明增值服务在 OEM App 内的售卖与履约怎么落地：适合谁、平台提供什么、核销结算方式，以及如何接入模板与接口。
针对 OEM App 接入虚拟服务，给出从商务签约、开通自有商城、额度采购，到商城订阅商品配置、渠道投放与 C 端对接的完整配置路径。
适用场景
在智能小程序等场景中，若你需要：
- 付费后才能用的能力或内容（订阅、解锁等），并希望有相对完整的购买与履约流程。
- 在 OEM App 内销售增值服务（下文以“网易云音乐”为例），自行收款、向涂鸦采购额度并按核销履约。
可考虑使用平台提供的增值服务方案，降低自建成本。
平台提供什么
平台侧覆盖 创建服务 → 用户购买 → 履约（开通/使用） 的闭环；你主要关注商品配置、收款/结算模式以及与开放接口的对接方式。
核销结算模式
商品配置、签约、计费细则以涂鸦增值服务及商务/交付文档为准；上线前务必与商务对齐。
接入流程与配置
以 “网易云音乐” 为例，在 OEM 场景下通常同时涉及两层能力：
- 设备侧播放授权：产品开通「AI 播放网易云音乐」高级功能，并在交付物采购时带上授权（详见智能体 音乐故事技能）。
- C 端增值服务售卖与核销：在 OEM 商城配置订阅 / 体验商品，用户在 OEM App 付款后履约开通服务凭证，并与涂鸦按额度核销。
下文按配置顺序给出完整链路；务必先完成服务与额度，再投放渠道，否则履约时可能找不到服务。
服务编码对照
以 “网易云音乐” 核销接入为例，配置商城商品、产品服务关联，以及 C 端获取商品和服务凭证，使用下列编码：
说明：
- 签约入口与服务大类一致：
https://www.tuya.com/vas/commodity/AI_COMPANION。 - C 端拉商品、查凭证时传
catalogCode: "AI_COMPANION"；凭证 / 能力明细里应对齐对接能力 codevas_ai_companion_fgv5zu5v2csg。 - 其他增值服务请替换为对接方下发的大类与能力 code，勿混用本表示例值。
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 增值服务商品页（服务大类 code：
AI_COMPANION；按页面指引完成签约与能力采购；具体 SKU / 计费以页面与商务确认为准）。 - 明确网易云音乐 服务大类
AI_COMPANION、对接能力vas_ai_companion_fgv5zu5v2csg（见上文编码对照），以及计费与履约规则（周期型订阅为主）。 - 申请交易入账所需的 物料编号，并按交付要求加入收入入账协同流程（月初账单确认等）。
- 确认数据中心范围：网易云音乐能力当前以中国数据中心为主；商城站点需按目标用户所在数据中心配置（各数据中心对应国家站点承接该中心下全部国家用户，而非仅该国用户）。
若编码或接口授权有疑问，通过 技术支持 / 工单 确认。
2. 开通 OEM 商城与店铺
OEM 客户需购买并开通自有商城，再在商家后台完成店铺与站点准备：
- 在商城套餐页开通 OEM 商城：商城开通 / 套餐定价。
- 开通完成后，登录商家后台（Tuya Smart Developer Center / 商城商家后台）。
- 进入已开通的 OEM 商城空间。
- 按业务切换目标数据中心，并选择对应国家站点 / 店铺进行配置。
- 确认店铺支付能力：按需开通微信 / 支付宝 / Apple IAP / Google IAP 等（以 OEM App 实际上架与商务开通结果为准）。
3. 核销签约与额度采购
核销模式要求客户先具备可扣减的服务库存额度（库存维度一般为：商家 IoT 账号 + 服务大类 + 服务项；充值后方可在 OEM App 售卖）。
- 若尚未完成签约，先通过 AI Companion 增值服务商品页 完成核销相关签约 / 采购（可按需选择服务 SKU、购买数量并提交报价申请）：
- 按商务合同采购网易云（或对应服务大类）的核销库存额度。
- 由涂鸦侧完成额度管控与充值（充值时需标注客户服务凭证 / 合同信息，便于对账）。
- 额度不足时，用户侧可能下单失败或履约失败；上线前与运营确认额度水位与预警。
采购与充值完成后，可在以下入口查看库存与变更明细：
VAS 侧入口示意（个人中心 → 我的订单 → 库存管理 → 点击跳转）：
IoT 平台「增值服务库存管理」示意（可查询购入 / 使用明细与库存水位）：
建议日常以以上入口核对采购、充值与扣减明细；上线前对齐库存水位，履约异常时优先核对是否库存不足或未充值到对应服务大类 / 服务项。
4. 配置虚拟产品与订阅计划
在 OEM 商城店铺中配置可售虚拟商品（网易云音乐月卡 / 年卡 / 体验包等）。下列截图来自商城商家后台配置流程，请在自有 OEM 商城中操作。
4.1 新建虚拟产品
- 进入「商品 → 商品库」，点击 新建商品。
- 若存在月套餐、年套餐等多个规格，建议勾选多规格；取消「这是实物产品」（勾选会导致结账要求收货地址）。
- 建议勾选「库存为 0 时继续销售」，避免 App 端因库存不足交易失败。
- 配置多规格（如月订阅 / 年订阅）。单规格与多规格不可互转；后续若要多规格，只能新建产品。
- 完善描述后保存并上架。
4.2 配置产品计划
在「订阅充值 → 产品计划」中为商品新增计划。仅单次购买时，不必开启「以订阅方式销售」；为各规格填写价格，并按需填入 Apple IAP / Google IAP Product ID：
需要自动续费时，打开「支持你的商品以一个订阅方式销售」，新建周期计划（计划类型、下单周期、试用 / 折扣等）：
月套餐示例：下单周期与履约周期保持一致（如 30 天）；首购折扣 / 试用与 Apple、Google 侧优惠保持一致：
计划列表示意（如月套餐 + 年套餐）：
其他配置要点：
- 希望「试用结束后自动扣费续期」：使用订阅计划内的提供试用，不要用普通支付做「假试用」。
- 订阅扣费一般会提前 1～2 个自然日，避免服务中断。
- 若作用对象是设备或家庭：计划中务必勾选对应信息，结账时会让用户选择家庭 / 设备；若不希望用户手选，可在跳转商品详情 URL 后拼接
uuid、devId等参数，系统优先使用链接参数。 - 强制走 IAP 的场景：未填 Apple / Google IAP 的选项可能在客户端被过滤不可见（需补齐 IAP 或按交付要求调整）：
- 将定价同步到所需支付渠道（Paypal / Stripe / Apple IAP / Google IAP 等）后再上架验证：
配置结果示例（可按业务裁剪）：
- 普通支付「7 天体验」：支付后开通 7 天权益，到期关闭（不自动续）。
- 订阅「月套餐」：周期 30 天，到期前自动扣费并生成新服务单。
- 订阅「年套餐」：周期 365 天，到期前自动扣费并生成新服务单。
4.3 Apple / Google IAP
若 OEM App 在 iOS / Android 商店售卖订阅：
- Apple：App Store Connect 创建订阅组与订阅项（或非续期订阅）；Product ID 回填商城计划；涂鸦 AM 商品流程当前不支持同组订阅升降级，勿配升降级策略；购买项须为「已批准」状态。
- Google：按「订阅 → 基础方案 → 优惠」结构配置；订阅 ID / 基础方案周期与商城计划对齐并激活。
Apple 侧关键界面示意：
商店侧细则以 Apple / Google 官方文档及交付 checklist 为准。
5. 产品关联履约服务
商品展示与支付配置完成后，必须配置「产品服务」，否则用户付款后不知道开通哪项能力：
- 在「订阅充值 → 产品服务」中，对目标商品点击 管理服务。
- 选择产品关联的服务大类（网易云对应大类 / catalogCode），并为各套餐配置履约服务与单次周期。
- 再次确认：履约周期 = 计划扣款周期（例如月订阅 → 30 天，年订阅 → 365 天）。
6. 渠道投放
顺序固定：先关联服务，再投放渠道。
OEM 核销投放入口：销售渠道 → OEM App 渠道 → 小程序 / 设备面板，添加商品生效范围：
设备面板投放时可绑定 PID、商品、标签，并圈定生效 App：
商品标签配置示意：
7. 售卖对接
商城与投放就绪后，在 OEM App 或面板 / 业务小程序中对接售卖与权益判断：
方案一：跳转通用购买页面
调用 getVasSpuList 获取商品基础信息与 commodityUrl，跳转通用购买页完成下单。
入参重点：catalogCode、bindingObjectType（APP / PID / 小程序）、bindingObjectCode、bindingTags（若有）、needSkuList、clientInfo.appScheme。
方案二：自定义购买流程
- 查询商城信息 -
getMallInfoV2 - 查询 SKU 列表 -
getSkuListV2 - 查询支付信息 -
getSkuPayment - 创建订单 -
createOrderV2 - 发起预支付 -
getPrepay
getPrepay 按履约对象传联系信息：家庭级 code: '3'（groupId 等），设备级 code: '4'（devId / uuid 等）。
查询用户凭证
调用 getCredentialList，用 catalogCode 判断是否已开通，并关注 effectiveEndDate、quotaUsage.leftQuantity 等。
核销模式下，用户在你方渠道付款后，需按对接方提供的履约 / 核销开放能力完成额度扣减与凭证开通；部分开放接口不对外自助公开，需通过工单申请后再联调，请勿猜测生产接口。
9. 设备侧能力与会员内容
仅完成商城售卖不够，设备要调用该能力还须：
- 产品开发中开通 AI 播放网易云音乐，并在开通状态下采购交付物（授权随设备；未开通即采购则设备无授权）。
- 智能体添加「音乐故事技能」并投放至该 PID。
- 面板可调用
getPanelAgentConfigNetEaseCloudMusic查询supportEnableNetEaseCloudMusic/enableNetEaseCloudMusic。 - 播放会员曲库：设备所有者在中国区面板「第三方内容授权」绑定网易账号（需厂家已购高级能力）。
10. 上线检查清单
自定义购买流程开发模板
模板用于快速搭建付费墙 / 应用内购买类页面，能力包括：
- 商品与 SKU 展示
- Apple / Google 应用内购买（IAP）
- PayPal、Stripe、支付宝、微信等第三方支付（按实际开通情况）
- 内置 Mock：无后端或未下发文案时，可在本地模拟购买流程，便于开发与演示
界面示例：
使用前准备
- 已注册涂鸦开发者账号，已创建小程序应用并拿到 miniAppId
- 已按上文完成 OEM 商城建品 / 核销投放（或对接方提供的测试商品）
- 已在平台开通应用内购买等相关能力
- 若要做真机支付联调，需熟悉 Apple IAP、Google Play 的上架与支付配置（各商店规则以官方为准）
接真实环境前必改项
在 src/constants/index.ts 中：
若暂时没有 CATEGORY_CODE 可通过 技术支持 / 工单 申请。
模板内主要页面
案例
详情请查看案例页：充值订阅