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