本文不是完整的支付方式可用性列表。某支付方式是否支持订阅、以及具体能力,以商户合约配置和
paymethodconfig/inquiry 返回结果为准。订阅状态与每期扣款结果始终以 Webhook 通知或主动查询为准。两种计费模式
订阅的续费由谁驱动,决定了大部分能力差异:- Waffo 托管 — 首期用户授权后,由 Waffo 按订阅周期自动向该支付方式发起后续扣款。卡、Apple Pay、Google Pay、PayPay、其他主流钱包与 Paidy 属于此类。
- 渠道托管 — 由支付渠道按其自身机制发起周期扣款,Waffo 不主动触发。PIX 属于此类。
计费与频次
Waffo 托管续期时间计算
以下规则仅适用于 Waffo 托管的自动续费。渠道托管 Subscription 由支付渠道按自身机制计算续期时间。 Waffo 以首期实际扣款成功时间作为初始计费基准,而不是 Subscription 创建时间。每期按以下公式推导下一期:下一期扣款时间 = 本期计费基准时间 + periodInterval × periodType
示例: 如果首期扣款在 2026 年 1 月 31 日 10:30:00 成功,且配置
MONTHLY + periodInterval: "1",下一期扣款时间为 2026 年 2 月 28 日 10:30:00。2 月 28 日写回计费游标后,再下一期扣款时间为 2026 年 3 月 28 日 10:30:00。试用与订阅管理
列说明
- 计费模式 — Waffo 托管:由 Waffo 按订阅周期自动发起扣款;渠道托管:由支付渠道按其机制发起周期扣款。
- 订阅模式 — 支付优先:续费失败即暂停服务、不再发起后续周期;服务优先:续费失败仍继续服务并按计划发起后续周期。
- 支持的订阅频次 — 通过“周期类型 + 间隔”设置;没有独立的“年”类型,年度用“月 × 12”表示。
- 试用期 — 可设置免费(0 元)或折扣试用;试用期金额须小于正式期金额。
- 订阅管理 — 能否通过 API 升级 / 降级套餐(
change)、修改金额(update)、设置未来生效(延迟生效)。“即将支持”表示能力正在开放中。 - 用户可发起取消 — 用户能否在支付方式侧自助解约(解约状态会回传 Waffo)。所有支付方式均可由商户侧调用取消,见下方通用规则。
所有支付方式通用
- 统一的订阅 API:创建、查询、取消、管理、升降级、修改。
- 创建订阅时
subscriptionManagementUrl(订阅管理页地址)为必填。 - 所有支付方式均可由商户侧调用取消订阅接口取消。
- 订阅退款遵循合约的退款规则(不允许 / 全额 / 部分)。
- PIX、DANA 按钱包侧重试规则进行重试,不支持商户自定义。
- 订阅状态变更与每期扣款结果通过 Webhook 通知。
相关链接
- 订阅能力概览见订阅与定期扣款
- 接口参数见订阅 API 文档
- 集成要点见支付方式集成注意事项
- 状态与事件枚举见数据参考