---
title: 集成方案
permalink: /notes/zh/integrate/subscription/integration/
createTime: '2026/07/15 16:30:00'
nosearch: true
llm:
exclude: true
description: '说明 Subscription 计划型订阅能力的接入步骤,覆盖创建订阅、首期授权支付、订阅通知、续费补扣、计划变更和取消订阅管理。'
---
本页是 Subscription 的接入主流程。`Subscription` 的适用场景,以及与 [Recurring](/notes/zh/integrate/recurring/overview/)、[CodeGrant](/notes/zh/integrate/tokenization/codeGrant/) 的方案选择对比,请见 [Subscription 概览](/notes/zh/integrate/subscription/);确认使用 Subscription 后,按本页步骤接入即可。
## 适用支付方式
- 收银台:通过 [创建订阅收银台会话](/notes/zh/subscription/api/sessionCreate/) 创建订阅计划和收银台会话,当前可展示的支付方式包括 `VISA`、`Mastercard`、`ApplePay`、`GooglePay`、`Klarna`、`PayPal`。
- `API Only`:通过 [创建订阅(API Only)](/notes/zh/subscription/api/create/) 直接创建订阅并提交首期支付,当前支持 `VISA`、`Mastercard` 以及已支持的 `ApplePay`、`GooglePay`、`Klarna`、`PayPal`。
两种模式的取舍见下文 [推荐接入模式](#推荐接入模式)。
## 支付流程
```mermaid
sequenceDiagram
participant Buyer as 👤 买家
participant Client as 💻 商户前端
participant Server as 🏪 商户服务端
participant PP as 🔄 PingPongCheckout
Note over Buyer,Client: 订阅选择与确认
Buyer->>Client: 查看套餐、价格、扣款周期、试用期和取消说明
Buyer->>Client: 选择套餐并确认订阅
alt 收银台
Client->>Server: 请求创建订阅收银台会话
Server->>PP: 创建订阅收银台会话
PP-->>Server: 返回 subscriptionId、token、innerJsUrl / paymentUrl
Server-->>Client: 返回收银台打开参数
Client-->>Buyer: 打开或跳转 PingPong 收银台
Buyer->>PP: 在收银台选择支付方式并完成首期支付或授权
PP-->>Buyer: 展示结果或跳回商户结果页
else API Only
Client-->>Buyer: 展示商户自建支付页或支付方式选择
Buyer->>Client: 输入支付信息或选择钱包/本地支付方式
Client->>Server: 提交订阅信息、支付要素和浏览器环境信息
Server->>PP: 创建订阅(API Only)并提交首期支付
PP-->>Server: 返回 subscriptionId、首期支付结果或后续动作
alt 需要买家继续完成动作
Server-->>Client: 返回 3DS、钱包授权或本地支付跳转信息
Client-->>Buyer: 引导买家完成 3DS 挑战、钱包授权或本地支付跳转
Buyer->>PP: 完成首期支付或授权
PP-->>Buyer: 展示结果或跳回商户结果页
else 不需要继续动作
Server-->>Client: 返回创建与首期支付结果
end
end
Note over PP,Server: 支付结果和订阅状态变化分别异步同步;图中上下顺序表示业务关联,不表示 webhook 到达顺序
PP-->>Server: 推送支付通知(首期支付结果)
Server-->>PP: 返回支付通知 HTTP 2xx ACK
PP-->>Server: 推送订阅通知(状态变化)
Server-->>PP: 返回订阅通知 HTTP 2xx ACK
Server-->>Client: 返回或刷新订阅结果
Client-->>Buyer: 展示订阅状态和服务开通结果
Note over PP,Server: 后续续费与生命周期管理
PP->>PP: 按订阅计划自动续费 / 试用转正 / 自动重试
PP-->>Server: 推送支付通知和订阅通知
Server-->>PP: 返回 HTTP 2xx ACK
Server->>PP: 必要时查询订阅详情或订阅支付记录
```
流程说明:
1. 商户前端应先向买家展示订阅价格、扣款周期、试用期、订阅条款和取消入口,并由买家确认订阅。
2. 商户服务端根据接入模式创建订阅:收银台模式先创建订阅收银台会话,再由买家在 PingPong 收银台完成首期支付或授权;`API Only` 模式由买家先在商户自建页面输入或选择支付方式,商户服务端再带支付要素创建订阅,并按接口返回继续完成 3DS、钱包授权或本地支付跳转。
3. 买家完成首期支付或授权后,商户应同时处理订阅层结果和支付层结果,其中订阅状态变化以 [订阅通知](/notes/zh/notify/subscription/notify/) 为核心。
4. 首期生效后,PingPong 会根据订阅配置自动维护后续计费周期、试用期和自动重试。
5. 当续费失败且开启自动重试时,订阅会进入 `PAST_DUE`,后续是否继续提供服务由商户根据业务规则决定。
## 推荐接入模式
如果您已经决定使用 `Subscription`,还需要继续选择收银台还是 `API Only`:
| 模式 | 更适合谁 | 首期支付体验 | 商户需要处理什么 | 推荐程度 |
|:---|:---|:---|:---|:---|
| 收银台 | 希望更快上线、由 PingPong 承接首期支付流程的团队 | 支持卡、钱包、3DS、内嵌和跳转 | 前端打开收银台,服务端处理通知和订阅状态 | 优先推荐 |
| `API Only` | 已有自建支付页、需要完全控制支付体验或已具备相应合规能力的团队 | 商户侧自定义,可能仍需继续完成 3DS 或钱包授权 | 上送支付要素、处理风控与后续动作、处理通知 | 适合进阶团队 |
优先选择收银台的典型情况:
- 首次上线订阅能力,希望尽量降低对支付流程的接入复杂度。
- 需要同时支持 `VISA` / `Mastercard` 卡、钱包和多种收银台支付方式。
- 不希望自己处理首期支付页、3DS 页面或钱包跳转细节。
更适合选择 `API Only` 的典型情况:
- 已经有成熟的自建支付页和服务端支付编排能力。
- 需要完全控制支付交互、表单结构和支付发起方式。
- 已具备相应的卡支付合规和风控对接能力。
## 接口列表
Subscription 集成通常涉及以下接口和通知:
| 阶段 |
类型 |
文档 |
是否必接 |
用途 |
| 创建与首期支付 |
API |
创建买家 |
必接 |
创建订阅前必须先创建买家,获得 customerId |
| API |
创建订阅收银台会话 |
按接入模式 |
创建订阅收银台会话,并返回支付链接、token 等前端继续处理所需信息 |
| API |
创建订阅(API Only) |
按接入模式 |
通过 API Only 创建订阅,并同步提交首期支付要素 |
| 通知 |
订阅通知 |
必接 |
接收订阅状态变化、试用转正、续费结果和计划更新结果 |
| 说明 |
通用异步通知接入说明 |
必读 |
了解通知地址配置、验签、幂等、ACK、重试和白名单等通用接入规则 |
| 通知 |
支付通知 |
推荐 |
获取首期支付或每期续费对应的支付层结果与支付方式明细(含 invoiceId) |
| API |
查询订阅详情 |
推荐 |
当通知延迟、补偿或核验状态时,拉取订阅最新快照 |
| 生命周期管理与对账 |
API |
查询订阅支付记录 |
推荐 |
查询每一期支付订单和退款关联信息 |
| API |
票据详情 |
推荐 |
按 invoiceId 查询票据金额、状态和客户信息(对账用) |
| API |
票据下载 |
推荐 |
获取票据 PDF 下载链接(30 天有效) |
| API |
凭证详情 |
推荐 |
按 receiptId 查询支付凭证(含退款记录) |
| API |
凭证下载 |
推荐 |
获取凭证 PDF 下载链接 |
| API |
预览订阅更新 |
按需 |
在正式更新前预估补扣、退款和生效方式 |
| API |
更新订阅 |
按需 |
更新金额、周期、商品信息和账单处理策略 |
| API |
取消订阅 |
按需 |
立即取消或在当前计费周期结束后取消订阅 |
## 集成准备
接入 Subscription 前,请先完成 [准备工作](/notes/zh/start/step/) 中的通用准备。
此外,请额外确认以下事项:
- 已为每个用户创建买家档案:通过 [创建买家](/notes/zh/subscription/invoice/customer/create/) 接口获得 `customerId`(创建订阅时必填,缺失报 `customerId: must not be blank`)。
- 已确定接入方式:收银台或 `API Only`。
- 已为每个订阅计划生成稳定且全局唯一的 `merchantSubscriptionId`,并为每次接口请求生成唯一的 `requestId`。
- 已准备可公网访问的订阅通知地址 `notifyUrl`。如果您还需要支付层异步结果,请同时准备支付结果通知地址。
- 已明确订阅业务规则:每期扣款金额、币种、周期单位、周期数量、首期收费方式、试用期、自动重试策略、何时停服以及取消规则。
- 已在商户侧准备好本地映射关系,至少保存 `merchantSubscriptionId`、`subscriptionId`、用户 ID、商品/套餐、订阅状态、当前周期和通知处理状态。
- 已在用户协议、订阅确认页或下单确认环节清晰展示订阅价格、扣款币种、扣款频率、订阅条款、试用期、续费失败处理方式以及如何取消订阅。
- 已准备面向用户的清晰取消入口,并在商户侧保留用户授权留痕。
- 已准备扣款提醒、试用转正提醒、invoice / receipt 发送和用户服务权益管理方案。这些用户触达和权益管理由商户负责,PingPong 负责订阅执行、通知和支付留痕。
## 集成步骤
请按以下步骤完成集成:
- 步骤 0:创建买家(前置,获得 `customerId`)
- 步骤 1:创建订阅
- 步骤 2:引导买家完成首期授权与支付
- 步骤 3:获取订阅结果和支付结果
- 步骤 4:管理续费、补扣与计划变更
### 步骤 0:创建买家(前置)
创建订阅前必须先创建买家档案,获得 `customerId`:
```json
// POST /v4/customers/create
{
"requestId": "REQ_CUST_001",
"partnerCustomerId": "user_merchant_001",
"firstName": "Emily",
"lastName": "Johnson",
"email": "emily.johnson@example.com",
"language": "en"
}
```
响应返回 `customerId`(如 `CUS-260507100000000001`),保存 `partnerCustomerId ↔ customerId` 映射,后续创建订阅时使用。
### 步骤 1:创建订阅
商户应先按 [推荐接入模式](#推荐接入模式) 选择收银台或 `API Only` 创建订阅,**请求中必须传入 `customerId`**。
创建订阅时建议优先关注以下关键字段:
| 字段 | 必填 | 说明 |
|:---|:---:|:---|
| `merchantSubscriptionId` | M | 商户定义的订阅计划唯一 ID,后续查询、更新、取消都建议持续使用 |
| `requestId` | M | 本次请求唯一编号 |
| `description` | M | 订阅计划描述,建议与商户商品或套餐名称一致 |
| `customerId` | M | PingPong 买家 ID(由[创建买家](/notes/zh/subscription/invoice/customer/create/)获得),用于关联买家档案 |
| `notifyUrl` | M | 订阅通知地址,用于接收订阅状态变化和计划更新结果 |
| `payResultUrl` | M | 首期支付完成后跳转回商户的支付结果页地址 |
| `flatPrice.amount` / `flatPrice.currency` | M | 每个正式计费周期的实际扣款金额和币种 |
| `period.unit` / `period.count` | M | 单个正式计费周期的单位和单位数量,例如 `MONTH` + `1` 表示每月计费一次 |
| `tradeCountry` | M | 收银台或交易国家,使用 ISO 3166-1 alpha-2 国家二字码;收银台和 API Only 均必填 |
| `shopperIP` | M | 用户发起订阅时的 IP 地址 |
| `goods` | M | 本次订阅对应的商品或服务信息,使用单个对象,不是数组;其中 `goods.unitPrice × goods.number` 之和须与 `flatPrice.amount` 一致,否则返回 `301012` |
| `billingAddress` | M | 账单地址,其中 `state` 为必填字段 |
| `device.orderTerminal` | M | 用户发起订阅的终端类型 |
| `jsGeneratedData` | C | API Only 卡支付必须传;获取失败时可传空字符串 |
| `totalPeriodCount` | O | 正式扣款总期数,不包含试用期;不传时不限制总期数 |
| `startAt` | O | 订阅开始时间;不传时通常按当前时间开始 |
| `endAt` | O | 订阅计划结束时间;保留该入参,未指定结束时间和总期数时持续自动续费 |
| `trial` | O | 试用期配置,仅包含 `startAt`、`endAt`、`periodDays`,不包含金额和币种 |
| `autoRecovery.enabled` | O | 是否开启续费失败后的自动重试 |
| `language` | O | 交互语言 |
创建订阅时,各时间字段应保持在同一条主时间轴上:
| 时间字段 / 节点 | 产品规则 |
|:---|:---|
| `startAt` | 整个订阅计划的生效时间,也是正式周期计算的主锚点 |
| `trial.startAt` | 不传时默认等于 `startAt`;传入时也应与 `startAt` 相等 |
| `trial.endAt` | 试用期结束时间;存在试用期时,也是首个正式计费周期开始和首次正式扣款时间 |
| 无试用期的首次正式扣款 | 在 `startAt` 执行;如果 `startAt` 晚于创建时间,创建后先完成支付方式绑定或授权,到 `startAt` 再正式扣款 |
| `endAt` | 到达该时间后不再生成新一期扣款任务;未指定结束时间和总期数时按订阅周期持续自动续费 |
`period.count` 表示一次计费周期包含多少个单位,`totalPeriodCount` 表示一共计费多少期。例如 `period={"unit":"MONTH","count":1}`、`totalPeriodCount=12` 表示共 12 个按月计费的正式周期;试用期不计入这 12 期。以下示例使用总期数,不同时指定 `endAt`。
模式差异说明:
- 收银台通过 `paymentMethods` 控制允许向买家展示的支付方式范围。
- `API Only` 通过 `paymentMethod` 上送本次首期支付的支付方式和支付要素。
- 如果您还需要支付层异步通知,两种创建接口均使用 `paymentNotifyUrl`。
收银台创建会话示例(仅展示 `bizContent`):
```json
{
"merchantSubscriptionId": "SUB_PLAN_202607150001",
"merchantTransactionId": "MT_SUB_202607150001",
"requestId": "REQ_SUB_SESSION_202607150001",
"description": "Premium monthly membership",
"notifyUrl": "https://merchant.example.com/notify/subscription",
"paymentNotifyUrl": "https://merchant.example.com/notify/payment",
"redirectUrl": "https://merchant.example.com/subscription/result",
"payCancelUrl": "https://merchant.example.com/subscription/cancel",
"payResultUrl": "https://merchant.example.com/subscription/result",
"flatPrice": {
"amount": "9.99",
"currency": "USD"
},
"language": "en",
"tradeCountry": "US",
"shopperIP": "8.8.8.8",
"customerId": "CUS-260507100000000001",
"period": {
"unit": "MONTH",
"count": 1
},
"totalPeriodCount": 12,
"trial": {
"periodDays": 7
},
"autoRecovery": {
"enabled": true
},
"paymentMethods": [
"VISA",
"Mastercard"
],
"goods": {
"name": "Premium membership",
"description": "Monthly membership service",
"sku": "MEMBERSHIP-001",
"unitPrice": "9.99",
"number": "1",
"imgUrl": "https://merchant.example.com/images/membership.png",
"virtualProduct": "Y",
"itemType": "3"
},
"billingAddress": {
"street": "1 Market St",
"postcode": "94105",
"city": "San Francisco",
"state": "CA",
"country": "US"
},
"browserInfo": {
"windowSize": "05",
"acceptHeader": "text/html,application/xhtml+xml",
"colorDepth": "32",
"screenHeight": "1080",
"screenWidth": "1920",
"jetLag": "480",
"userAgent": "Mozilla/5.0",
"javaEnabled": false,
"javaScriptEnabled": true
},
"device": {
"orderTerminal": "02"
}
}
```
`API Only` 创建订阅示例(仅展示 `bizContent`):
```json
{
"merchantSubscriptionId": "SUB_PLAN_202607150002",
"requestId": "REQ_SUB_DIRECT_202607150001",
"description": "Premium monthly membership",
"notifyUrl": "https://merchant.example.com/notify/subscription",
"paymentNotifyUrl": "https://merchant.example.com/notify/payment",
"redirectUrl": "https://merchant.example.com/subscription/result",
"payResultUrl": "https://merchant.example.com/subscription/result",
"flatPrice": {
"amount": "9.99",
"currency": "USD"
},
"language": "en",
"tradeCountry": "US",
"shopperIP": "8.8.8.8",
"customerId": "CUS-260507100000000001",
"period": {
"unit": "MONTH",
"count": 1
},
"totalPeriodCount": 12,
"autoRecovery": {
"enabled": true
},
"paymentMethod": {
"type": "scheme",
"cardInfo": {
"number": "4111111111111111",
"expireMonth": "12",
"expireYear": "2030",
"holderFirstName": "John",
"holderLastName": "Smith",
"cvv": "123"
}
},
"jsGeneratedData": "",
"goods": {
"name": "Premium membership",
"description": "Monthly membership service",
"sku": "MEMBERSHIP-001",
"unitPrice": "9.99",
"number": "1",
"imgUrl": "https://merchant.example.com/images/membership.png",
"virtualProduct": "Y",
"itemType": "3"
},
"billingAddress": {
"street": "1 Market St",
"postcode": "94105",
"city": "San Francisco",
"state": "CA",
"country": "US"
},
"browserInfo": {
"windowSize": "05",
"acceptHeader": "text/html,application/xhtml+xml",
"colorDepth": "32",
"screenHeight": "1080",
"screenWidth": "1920",
"jetLag": "480",
"userAgent": "Mozilla/5.0",
"javaEnabled": false,
"javaScriptEnabled": true
},
"device": {
"orderTerminal": "02"
}
}
```
::: warning 注意
- 创建成功的同步响应不等于订阅已经正式生效。
- 首期支付结果和订阅状态变更必须通过服务端通知或主动查询确认。
- 如果首期支付依赖 3DS 挑战、钱包授权或跳转流程,只有这些后续动作完成后,订阅才可能进入 `IN_TRIAL` 或 `ACTIVE`。
- 对同一用户重复创建同一业务订阅前,建议先在商户侧检查 `merchantSubscriptionId` 是否已存在,避免产生重复订阅。
- 如果创建接口超时、返回网关错误或结果不确定,不要立即换一个新的 `merchantSubscriptionId` 重建。应先使用原商户订阅 ID 查询订阅,确认是否已经创建成功,再决定是否重试。
:::
### 步骤 2:引导买家完成首期授权与支付
创建订阅后,商户应根据接入模式继续完成首期支付:
- 收银台:将返回的 `paymentUrl`、`innerJsUrl` 或 `token` 用于前端打开订阅收银台,由买家在 PingPong 页面完成首期支付或授权。
- `API Only`:若同步响应返回 `action`、跳转地址或其他后续动作,商户应继续引导买家完成 3DS 挑战或钱包授权绑定。
处理建议:
1. 不要仅根据前端跳转完成就开通服务。
2. `redirectUrl` 只是买家完成支付流程后的跳转地址,不代表订阅一定已经生效。
3. 如果买家中途退出、挑战失败或支付失败,订阅可能保持 `PENDING` 或首期支付失败,商户不应提前授予订阅权益。
### 步骤 3:获取订阅结果和支付结果
订阅场景需要同时消费三类结果,分别回答三个不同的问题:
| 结果 | 回答的问题 | 订阅方式 | 建议幂等键 |
|:---|:---|:---|:---|
| 订阅结果 | 订阅当前是否生效、能否继续提供服务 | [订阅通知](/notes/zh/notify/subscription/notify/) | `subscriptionId + notifyType + updateAt` |
| 支付结果 | 首期或某一期扣款是否成功、扣了多少 | [支付通知](/notes/zh/notify/payment/notify/) | `transactionId` |
| 退款结果 | Update 或 Cancel 触发的退款是否完成 | [退款通知](/notes/zh/notify/refundNotify/) | `merchantRefundId` |
**服务开通以订阅结果为准**;支付结果用于对账,退款结果用于资金确认。
接入顺序建议:
1. 必接 [订阅通知](/notes/zh/notify/subscription/notify/),按 [通用异步通知接入说明](/notes/zh/onlinePayment/developer/paymentNotify/) 完成地址配置、验签、幂等和 ACK。
2. 推荐同时接收 [支付通知](/notes/zh/notify/payment/notify/);涉及退款时再接收 [退款通知](/notes/zh/notify/refundNotify/)。
3. 通知延迟、丢失或需补偿时,用 [查询订阅详情](/notes/zh/subscription/api/query/) 拉订阅状态,用 [查询订阅支付记录](/notes/zh/subscription/api/paymentsQuery/) 拉每期支付结果。
各通知的字段含义(`notifyType`、`status`、`currentPeriod`、`merchantTransactionId` 等)请见对应通知参考页。
### 步骤 4:管理续费、补扣与计划变更
首期生效后,PingPong 会根据订阅计划自动推进后续续费、试用转正和计划变更。商户侧建议始终分两条线处理:
| 处理层 | 要回答的问题 | 推荐关注字段 | 推荐获取方式 |
|:---|:---|:---|:---|
| 订阅层 | 这个订阅现在还能不能继续给服务 | `notifyType`、`status`、`currentPeriod`、`cancelReason` | [订阅通知](/notes/zh/notify/subscription/notify/) + [查询订阅详情](/notes/zh/subscription/api/query/) |
| 支付层 | 这一期有没有实际扣款成功、是否发生补扣或退款 | `paymentRecords`、`merchantTransactionId`、`transactionId`、`amount`、`currency`、`status` | [支付通知](/notes/zh/notify/payment/notify/) + [查询订阅支付记录](/notes/zh/subscription/api/paymentsQuery/) |
#### 1. 处理续费与补扣
每个计费周期到期时,PingPong 会按订阅计划自动发起续费。续费失败并开启 `autoRecovery.enabled=true` 时,订阅可能进入 `PAST_DUE`,商户应结合订阅状态、支付记录和自身宽限期策略决定是否继续提供服务。
更多续费失败、自动重试、补扣和查询建议,请查看 [续费与自动恢复](/notes/zh/integrate/subscription/renewal-recovery/)。
#### 2. 查询订阅计划与支付记录
- 使用 [查询订阅详情](/notes/zh/subscription/api/query/) 获取订阅最新状态、当前周期、试用期、自动重试配置和摘要记录。
- 使用 [查询订阅支付记录](/notes/zh/subscription/api/paymentsQuery/) 查询每一期支付订单、退款关联和支付方式信息。
如果您需要判断用户是否继续享有订阅权益,优先看订阅状态;如果需要确认某一期资金结果,优先看支付记录和通知。
#### 3. 预览并执行计划变更
需要升级/降级套餐、修改金额、调整周期或变更商品信息时,建议先调用 [预览订阅更新](/notes/zh/subscription/api/preview/) 预估补扣或退款,再调用 [更新订阅](/notes/zh/subscription/api/update/) 正式提交变更。
通过收银台创建的订阅,若变更产生的补扣需要买家继续支付,Update 响应会返回 `action.paymentRedirectUrl` 收银台地址,商户需将买家重定向到该地址完成支付,详见 [Update 与 Cancel 规则 · 收银台订阅的补扣跳转支付](/notes/zh/integrate/subscription/update-cancel/#收银台订阅的补扣跳转支付)。
计划变更涉及 `effectiveMode`、`billingAction`、`prorationMode` 组合,不同组合会影响生效时间、账单锚点、补扣和退款。详细规则请查看 [Update 与 Cancel 规则](/notes/zh/integrate/subscription/update-cancel/)。
#### 4. Update 与 Cancel 的关系
如果订阅计划存在未完成或已完成的 Update,Cancel 是否允许执行会受到 Update 状态和新周期开始时间影响。即使 `cancelAtPeriodEnd=true` 表示周期末取消,也不能绕过 Update 门禁。
完整门禁、立即取消/周期末取消、Update 与 Cancel 各自 `prorationMode` 的关系,请查看 [Update 与 Cancel 规则](/notes/zh/integrate/subscription/update-cancel/)。
#### 5. Invoice 对账
每笔扣款成功后 PingPong 会生成票据(invoice)和支付凭证(receipt):
- **invoiceId 获取**:支付通知(`paymentNotifyUrl`)的报文中携带 `invoiceId` 字段;
- **票据查询**:用 [票据详情](/notes/zh/subscription/invoice/query/) 按 `invoiceId` 查询金额、状态、客户信息;
- **票据下载**:用 [票据下载](/notes/zh/subscription/invoice/download/) 获取 PDF 下载链接(30 天有效);
- **凭证查询**:用 [凭证详情](/notes/zh/subscription/invoice/receiptQuery/) 按 `receiptId` 查询(`receiptId` 从 [凭证创建通知](/notes/zh/notify/invoice/receiptCreated/) 获取);
- **凭证下载**:用 [凭证下载](/notes/zh/subscription/invoice/receiptDownload/) 获取 PDF 下载链接。
详细对账指引和票据节奏请查看 [Invoice 对账](/notes/zh/integrate/subscription/invoice-reconciliation/)。
## 下一步阅读
完成集成主流程后,各专题的深入规则请返回 [Subscription 概览](/notes/zh/integrate/subscription/) 查看完整阅读指引(订阅状态与通知、续费与自动恢复、Update 与 Cancel 规则、场景与最佳实践)。
## 接入检查清单
上线前建议确认:
- 已保存 `merchantSubscriptionId`、`subscriptionId`、`customerId`、订阅状态、当前周期、金额币种和最近一次事件信息。
- 已分别处理订阅通知、支付通知和退款通知,并按各自维度做幂等。
- 已准备通知延迟或丢失时的补偿查询逻辑。
- 已明确 `PAST_DUE`、试用转正失败、周期末取消和立即取消时的用户权益处理规则。
- 已向用户展示订阅周期、续费金额、试用规则、取消入口和必要的扣款提醒。