---
title: "訂閱"
description: "了解如何使用 Tokenz 訂閱 API 銷售週期性商品——從在結帳時建立訂閱，到計費、催收、方案變更和取消的完整流程。"
source: "https://docs.tokenz.one/zh-TW/v2/subscriptions"
api_version: "v2"
locale: "zh-TW"
version_status: "current"
docs_stage: "prod"
---

# 訂閱

了解如何使用 Tokenz 訂閱 API 銷售週期性商品——從在結帳時建立訂閱，到計費、催收、方案變更和取消的完整流程。

訂閱會按照固定的週期（每週、每月或每年）自動建立新訂單，並向消費者已儲存的支付方式扣款，只要訂閱保持有效狀態就會持續進行。Tokenz 為您管理完整的計費生命週期：安排續訂扣款、重試失敗的付款、發送續訂提醒，並在每個環節透過 webhook 通知您的後端。

**金額格式：** `amount` 等金額欄位以每種貨幣的最小輔助單位表示。有關每種貨幣的具體編碼方式，請參見[支援的貨幣](https://docs.tokenz.one/zh-TW/v2/checkout/currency)。

> **注意：** 訂閱目前僅適用於使用記錄商戶（Merchant of Record，MOR）模式的商戶。

## 概述

訂閱 API 建構在與單次訂單相同的 [Checkout Session](https://docs.tokenz.one/zh-TW/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-TW/v2/subscriptions/lifecycle) — 深入介紹狀態、計費週期、試用期、催收、取消和續訂提醒
- [整合訂閱](https://docs.tokenz.one/zh-TW/v2/subscriptions/get-started) — 建立訂閱結帳、啟用訂閱並觸發續訂
- [支付方式與授權](https://docs.tokenz.one/zh-TW/v2/subscriptions/payment-methods) — MIT 授權的運作原理，以及消費者如何更新卡片
- [Webhook](https://docs.tokenz.one/zh-TW/v2/subscriptions/webhooks) — 完整的事件目錄及範例負載