PayPal 定期付款模块
Recurring Payments Module — 帮助 merchant 在付款页面展示定期付款信息，增加客户信任度及转化率
什么是定期付款？
定期付款是指 merchant 根据预设的时间表或其他条件向 payer 发起的付款。常见的例子包括：
📺
订阅服务
串流媒体、宠物食品配送
⚡
自动账单
水电费、手机月费
💰
自动充值
道路通行费、预付卡
📊
分期付款
大额商品分期
🔹
先保存，后扣款
Without Purchase
无需立即交易，先保存付款方式，日后发起扣款。适用于免费试用、后付费服务等场景。
Create Setup Token
Payment Tokens API
billing_plan
🔸
付款同时保存
With Purchase
第一次交易同时保存付款方式至 vault，后续使用 vault_id 发起定期扣款。
Create Order
store_in_vault
Orders API
四种定期付款类型
PayPal 根据不同金额、频率和期限组合，定义了以下四种类型：
| 类型 | 金额 | 频率 | 期限 | 示例 |
|---|---|---|---|---|
| 📅 订阅 (Subscription) | 固定 | 固定周期 | 无固定期限 | $5.99/月 串流媒体 |
| 🔄 定期 (Recurring) | 可变 | 固定周期 | 无固定期限 | 每月水电费 |
| ⚡ 不定时 (Unscheduled) | 固定/可变 | 不定 | 无固定期限 | 预付卡自动充值 |
| 📊 分期 (Installment) | 固定 | 固定周期 | 有固定期限 | $999 分12期 |
Merchant 的三个选项
关于传递定期付款类型和 billing plan 信息，merchant 有三种选择：
✅ 传递 usage_pattern + billing_plan.name + billing_cycles
Payer 在 PayPal 界面上看到完整计划详情（金额、周期、试用期等）
推荐用于：标准订阅、分期付款等清晰定价场景
⚠️ 仅传递 usage_pattern
Payer 看到通用定期付款流程，不显示具体计划详情
推荐用于：复杂定价结构（如按使用量计费），Merchant 需要在自己网站提前说明条款
❌ 两者都不传递
Payer 看到非定期付款的标准流程，不推荐用于定期交易
不推荐用于定期付款场景