---
title: "创建虚拟货币"
description: "在 Adapty 中创建虚拟货币，将其关联到产品，使购买行为可授予积分，并设置积分是否过期。"
---

:::link
主要文章：[虚拟货币](virtual-currencies)
:::

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

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

## 创建虚拟货币 \{#create-a-virtual-currency\}

在 Adapty 看板中，打开 **Products** > [**Virtual currency**](https://app.adapty.io/virtual-currency)。

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

1. 点击 **New virtual currency**，侧边栏将在 **General** 步骤处打开。
2. 填写货币详情：
    - **Code**：货币在应用内的唯一**永久**标识符，例如 `COINS`。用于在服务端 API 中标识该货币，并追踪每位用户的余额。
    
使用拉丁字母、数字和下划线，最多 32 个字符。小写字母会自动转换为大写。
    - **Name**：显示名称，例如 `Gold`。可以在之后修改。
    - **Description**：关于该货币的可选备注。
3. 点击 **Continue** 进入 **Link Products** 步骤。

:::important
货币的 **Code** 一旦创建就无法更改。但 **Name** 可以在之后编辑。
:::

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

## 关联产品 \{#link-products\}

将产品与虚拟货币关联，这样购买或续订即可获得该货币的积分。您可以将一个产品关联到多种货币，也可以将一种货币关联到多个产品。您可以在 **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。

## 后续步骤 \{#next-steps\}

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

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