要出售虚拟货币积分，需先定义一种虚拟货币，再将其关联到你的产品。

整个流程分为两步——本文均有详细说明。关联产品后，每次购买或续订都会自动授予积分。

创建虚拟货币

在 Adapty 看板中，打开 Products > Virtual currency。

创建虚拟货币的步骤如下：

1. 点击 New virtual currency，侧边栏将在 General 步骤处打开。
2. 填写货币详情：
   • Code：货币在应用内的唯一永久标识符，例如 COINS。用于在服务端 API 中标识该货币，并追踪每位用户的余额。

使用拉丁字母、数字和下划线，最多 32 个字符。小写字母会自动转换为大写。

• Name：显示名称，例如 Gold。可以在之后修改。
• Description：关于该货币的可选备注。

3. 点击 Continue 进入 Link Products 步骤。

当你引入一种新货币时，每个用户画像的初始余额为 0。

关联产品

将产品与虚拟货币关联，这样购买或续订即可获得该货币的积分。您可以将一个产品关联到多种货币，也可以将一种货币关联到多个产品。您可以在 Link Products 步骤中立即关联产品，也可以在后续编辑货币时再添加。

在 Link Products 步骤中，Associated products 部分列出了可授予此货币的产品。如需添加，请点击 Add associated products，然后选择一个产品。

每次授予都会累加到用户的余额中，而不是替换原有余额，因此来自不同产品的点数会不断累积。点数设置取决于产品类型：

• 订阅产品有三个积分设置：
  • Credit per cycle（必填）：每次续订时授予的积分，包括将试用期转为付费的那次续订。
  • Credit on trial start（可选）：试用期开始时单独授予的一次性积分。
  • Credits expire at the end of each billing cycle（开关）：开启后，Adapty 会在每次续订时先将未使用的积分重置为 0，再授予新周期的积分；关闭后，积分跨周期累积，永不过期。
• 一次性购买产品：设置 Credit amount，即每次购买授予的积分数量。一次性积分永不过期。

点击 Save 创建货币及其产品链接。

产品链接仅对未来的交易生效。新链接的产品将从下一次购买或续订时开始授予积分。Adapty 不会自动向当前订阅者发放货币——他们需要先续订订阅。移除链接后，未来的发放将停止，但已授予的积分不受影响。

当过期开关开启时，到期积分将遵循订阅生命周期：

• 在账单重试或宽限期内，Adapty 不会授予新的积分。
• 取消订阅后，积分在付费周期结束前保持有效。
• 订阅到期时，Adapty 会将剩余积分重置为 0。

后续步骤

创建货币并关联产品后，购买操作将自动发放积分。接下来你可以：

• 在 Virtual currency balance 页面追踪每位用户的余额。
• 通过服务端 API 在运行时发放、消耗和读取余额：Create virtual currency transaction 和 List virtual currency balances。如需完整示例，请参阅 Virtual currency quickstart。