如何在PayPal订阅升级时跳过新套餐的试用周期？

现有套餐配置 #

• Basic套餐：7天免费试用（0美元），之后每月自动扣费10美元（无限循环）
• Premium套餐：7天免费试用（0美元），之后每月自动扣费20美元（无限循环）

需求场景 #

用户购买Basic套餐3天后升级至Premium套餐，需直接进入Premium的常规计费周期，跳过其7天免费试用阶段。

失败尝试回顾 #

1. 自定义billing_cycles将Premium试用周期的total_cycles设为0，触发错误：{"name":"UNPROCESSABLE_ENTITY","issue":"INVALID_TRIAL_BILLING_TOTAL_CYCLES","description":"Total cycles for trial billing must be greater than '0'."}
2. 仅传入Premium的常规计费周期配置，无报错但订阅仍保留试用阶段

可行解决方案（无需新建套餐） #

调用PayPal的/v1/billing/subscriptions/{id}/revise端点时，需在请求体中指定Premium套餐的plan_id，同时通过replace_billing_cycles: true参数替换原套餐的计费周期，只保留常规计费阶段。具体请求体示例如下：

{
  "plan_id": "你的Premium套餐ID",
  "replace_billing_cycles": true,
  "billing_cycles": [
    {
      "frequency": {
        "interval_unit": "MONTH",
        "interval_count": 1
      },
      "sequence": 1,
      "tenure_type": "REGULAR",
      "pricing_scheme": {
        "fixed_price": {
          "value": "20",
          "currency_code": "USD"
        }
      },
      "total_cycles": 0
    }
  ],
  "payment_preferences": {
    "auto_bill_outstanding": true,
    "setup_fee": {
      "value": "0",
      "currency_code": "USD"
    },
    "setup_fee_failure_action": "CONTINUE",
    "payment_failure_threshold": 3
  }
}

关键说明 #

• replace_billing_cycles: true：该参数会强制用你自定义的计费周期替换目标套餐（Premium）原有的所有周期配置，避免默认继承试用阶段
• 自定义billing_cycles仅保留常规计费阶段：将sequence设为1，tenure_type指定为REGULAR，直接应用Premium的月度计费规则，完全跳过试用环节

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