--- title: 概览 permalink: /notes/zh/integrate/subscription/ createTime: '2026/07/15 16:30:00' nosearch: true llm: exclude: true description: '介绍 Subscription 是什么、适用场景,以及 Subscription、Recurring、CodeGrant 的方案选择建议。' --- `Subscription` 是 PingPongCheckout 提供的计划型订阅能力,适用于固定金额、固定计费周期的商品或服务,例如会员自动续费、SaaS 包月/包年、试用转正、内容订阅、按周期发货或按周期发放权益等场景。 与卡支付场景的 [Recurring](/notes/zh/integrate/recurring/overview/) 不同,Subscription 会在 PingPong 侧维护订阅计划、计费周期、试用期、自动重试和订阅状态,并通过订阅通知把生命周期变化同步给商户。 如果您只是需要卡支付场景下的保存卡和后续 MIT 扣款,可以查看 [Recurring](/notes/zh/integrate/recurring/overview/);如果您需要钱包或本地支付方式的授权绑定,可以查看 [CodeGrant](/notes/zh/integrate/tokenization/codeGrant/)。 ## 什么时候使用 Subscription 如果您的业务符合以下任一特征,通常更适合使用 Subscription: - 有明确的计费周期,例如按月、按年或按固定天数续费。 - 需要 PingPong 帮助维护订阅状态,例如 `PENDING`、`IN_TRIAL`、`ACTIVE`、`PAST_DUE`、`CANCELLED`。 - 需要支持试用期、试用转正、续费失败自动重试。 - 需要做套餐升级、降级、周期调整,并希望有 Preview / Update 能力预估补扣或退款。 - 需要通过订阅通知持续同步生命周期变化,而不是只处理单笔支付结果。 如果您只是需要“保存支付凭证或授权关系,后续由商户自己决定什么时候扣款”,通常不需要 Subscription:卡支付 MIT 场景优先评估 Recurring,钱包或本地支付方式授权绑定场景优先评估 CodeGrant。 ## Subscription / Recurring / CodeGrant 怎么选 | 方案 | 适合场景 | 谁维护扣款计划 | 是否维护订阅状态 | 是否支持试用期 / 自动重试 | 推荐阅读 | |:---|:---|:---|:---:|:---:|:---| | `Subscription` | 标准会员、SaaS 套餐、固定周期续费、试用转正、套餐升级/降级 | PingPong + 商户共同维护 | 是 | 是 | [集成方案](/notes/zh/integrate/subscription/integration/) | | `Recurring` | 卡支付保存卡后,由商户自行决定后续 MIT 扣款时间 | 商户 | 否 | 否 | [Recurring](/notes/zh/integrate/recurring/overview/) | | `CodeGrant` | 钱包或本地支付方式先授权后支付,希望保存授权关系和支付凭证 | 商户 | 否 | 否 | [CodeGrant](/notes/zh/integrate/tokenization/codeGrant/) | 可以用一句话理解三者差异: - `Subscription`:PingPong 帮您维护“订阅计划和订阅生命周期”。 - `Recurring`:用于卡支付保存卡后的“后续 MIT 扣款”,扣款计划由商户维护。 - `CodeGrant`:用于钱包或本地支付方式的“授权绑定”,后续怎么使用授权关系由商户维护。 ## 快速决策 | 您的问题 | 推荐方案 | |:---|:---| | 我需要固定周期自动续费,并希望平台维护订阅状态 | `Subscription` | | 我需要 7 天试用,到期后自动转正扣款 | `Subscription` | | 我需要续费失败后自动重试,并收到订阅状态变化通知 | `Subscription` | | 我只需要卡支付保存卡,之后商户系统自己决定何时发起 MIT 扣款 | `Recurring` | | 我主要是在钱包或本地支付方式侧做授权绑定,然后拿到 token / 授权凭证 | `CodeGrant` | | 我不确定用户是否需要完整订阅生命周期,只是想先保存支付凭证 | 卡支付评估 `Recurring`,钱包或本地支付方式评估 `CodeGrant`,不要直接把支付凭证能力理解成订阅能力 | ## 收银台还是 API Only 确认使用 Subscription 后,还需要选择创建订阅的接入方式: - 收银台:由 PingPong 承接首期支付页面、3DS 挑战和钱包跳转流程,更适合希望快速上线的团队。 - `API Only`:由商户自建支付页并直接上送支付要素,更适合需要完全控制支付体验且已具备相应合规和风控能力的团队。 详细接入差异、接口选择和首期支付流程,请继续阅读 [集成方案](/notes/zh/integrate/subscription/integration/#推荐接入模式)。 ## 订阅接入的核心结果 Subscription 场景里通常需要同时理解三类结果:订阅结果(订阅是否生效/试用/欠费/取消)、支付结果(首期或每期扣款是否成功)、退款结果(Update 或 Cancel 触发的退款是否完成)。服务是否继续提供,建议优先以订阅层状态为准;单笔支付和退款结果用于财务、对账和异常补偿。 三类结果各自的获取方式、关注字段和幂等建议,详见 [集成方案 · 获取订阅结果和支付结果](/notes/zh/integrate/subscription/integration/#步骤-3:获取订阅结果和支付结果)。 ## 下一步阅读 | 页面 | 适合查看的问题 | |:---|:---| | [集成方案](/notes/zh/integrate/subscription/integration/) | 如何创建订阅、完成首期支付、处理通知、查询状态,以及进入续费和计划变更流程 | | [订阅状态与通知](/notes/zh/integrate/subscription/lifecycle/) | 如何理解订阅状态、`currentPeriod`、`cancelReason`,以及订阅通知、支付通知、退款通知的关系 | | [续费与自动恢复](/notes/zh/integrate/subscription/renewal-recovery/) | 续费失败、`PAST_DUE`、自动重试、补扣和支付记录查询怎么处理 | | [Update 与 Cancel 规则](/notes/zh/integrate/subscription/update-cancel/) | 计划变更、立即生效 / 下周期生效、Cancel 门禁、退款和 `prorationMode` 怎么理解 | | [Invoice 对账](/notes/zh/integrate/subscription/invoice-reconciliation/) | 票据 / 凭证的生成节奏、`invoiceId` 与 `receiptId` 获取路径、查询下载接口和票据类 webhook 事件 | | [场景与最佳实践](/notes/zh/integrate/subscription/best-practices/) | 免费试用、套餐升级、周期末取消、本地字段映射、幂等和补偿查询建议 |