---
title: "订阅"
description: "了解如何使用 Tokenz 订阅 API 销售周期性商品——从在结账时创建订阅，到计费、催收、方案变更和取消的完整流程。"
source: "https://docs.tokenz.one/zh-CN/v2/subscriptions"
api_version: "v2"
locale: "zh-CN"
version_status: "current"
docs_stage: "prod"
---

# 订阅

了解如何使用 Tokenz 订阅 API 销售周期性商品——从在结账时创建订阅，到计费、催收、方案变更和取消的完整流程。

订阅会按照固定的周期（每周、每月或每年）自动创建新订单，并向消费者已保存的支付方式扣款，只要订阅保持有效状态就会持续进行。Tokenz 为您管理完整的计费生命周期：安排续订扣款、重试失败的付款、发送续订提醒，并在每个环节通过 webhook 通知您的后端。

**金额格式：** `amount` 等金额字段以每种货币的最小辅助单位表示。有关每种货币的具体编码方式，请参见[支持的货币](https://docs.tokenz.one/zh-CN/v2/checkout/currency)。

> **注意：** 订阅目前仅适用于使用记录商户（Merchant of Record，MOR）模式的商户。

## 概述

订阅 API 构建在与一次性订单相同的 [Checkout Session](https://docs.tokenz.one/zh-CN/v2/checkout) 基础之上：

- **创建**：通过创建包含 `subscription` 字段块的 Checkout Session 来启动订阅。每个订阅只允许包含一个未打折的商品。
- **授权**：消费者完成一次卡支付（可带或不带试用期）。此过程同时会获取商户发起交易（MIT）同意，以便后续续订无需消费者再次操作即可扣款。
- **自动扣款**：只要订阅处于 `active` 状态，Tokenz 就会在每个计费周期结束时创建新订单并向已保存的卡扣款。
- **管理**：消费者可以通过 Tokenz 托管流程更新自己的支付方式，商户可以代表消费者变更方案或取消订阅。
- **响应**：您的后端会在每次生命周期转换时收到 webhook（试用开始、激活、续订、未付款、支付方式更新、方案变更、取消、过期）。

## 核心概念

- **订阅（Subscription）**：周期性计费的记录，保存价格、计费间隔、试用配置、催收策略、当前计费周期以及消费者的支付方式。
- **计费间隔（Billing interval）**：订阅续订的频率，由 `unit`（`WEEK`、`MONTH` 或 `YEAR`）和 `count`（两次续订之间的单位数）组成。按月和按年续订会在与首次扣款相同的日期进行（若目标月份没有对应日期，则顺延至该月最后一天）。
- **试用期（Trial period）**：首次扣款前的可选天数（1–365 天）。如果设置了试用期，订阅创建时不会生成初始订单，试用结束时会自动创建首个订单。
- **支付方式同意（Payment method consent）**：订阅仅支持卡类支付方式。消费者的首次授权（或专门的同意流程）会授权 Tokenz 在后续续订时再次向该卡扣款，而无需每次都进行 3D 验证。
- **催收（Dunning）**：当续订扣款失败时，在订阅过期之前所采用的重试策略。
- **方案变更（Plan change）**：更改订阅商品和/或计费间隔的请求，可以立即生效（并按比例分摊费用），也可以延后到下一个计费周期生效。

## 本指南内容

- [生命周期与计费](https://docs.tokenz.one/zh-CN/v2/subscriptions/lifecycle) — 深入介绍状态、计费周期、试用期、催收、取消和续订提醒
- [集成订阅](https://docs.tokenz.one/zh-CN/v2/subscriptions/get-started) — 创建订阅结账、激活订阅并触发续订
- [支付方式与授权](https://docs.tokenz.one/zh-CN/v2/subscriptions/payment-methods) — MIT 授权的工作原理，以及消费者如何更新卡片
- [Webhook](https://docs.tokenz.one/zh-CN/v2/subscriptions/webhooks) — 完整的事件目录及示例负载