PayPal API 如何设置自定义账单计费频率？

PayPal官方的计费频率单位枚举没有直接提供QUARTERLY选项，按季度计费需要通过频率单位和间隔的组合实现，操作方法如下：

核心配置逻辑 #

在创建账单计划的billing_cycles（计费周期）参数中，找到对应常规计费的周期配置，做如下设置即可实现每3个月（即1季度）扣费一次的效果：

• frequency.interval_unit 设为 MONTH（月）
• frequency.interval_count 设为 3（间隔3个单位周期）

v2 订阅API请求示例片段 #

{
  "product_id": "PROD-XXXXXXXXX", // 替换为你的产品ID
  "name": "季度会员计划",
  "billing_cycles": [
    {
      "frequency": {
        "interval_unit": "MONTH",
        "interval_count": 3
      },
      "tenure_type": "REGULAR",
      "sequence": 1,
      "total_cycles": 0, // 0表示永久续费直到用户取消，可填固定数值代表总扣费季度数
      "pricing_scheme": {
        "fixed_price": {
          "value": "99",
          "currency_code": "CNY"
        }
      }
    }
  ],
  "payment_preferences": {
    "auto_bill_outstanding": true,
    "payment_failure_threshold": 3
  }
}

注意事项 #

• 不要直接在interval_unit字段传入QUARTERLY字符串，该值不在PayPal官方枚举范围内，会触发参数校验错误。
• 如果你使用的是v1版本计费计划API，配置逻辑一致，对应字段为frequency.unit设为Month、frequency.interval设为3即可。
• 配置完成后调用查询计划详情接口，返回的计费描述会自动展示为每3个月扣费，完全匹配季度计费的需求。

内容的提问来源于stack exchange，提问作者Spyker