如何通过PayPal API结束订阅试用并启动常规计费周期？

当前订阅状态分析 #

从你提供的billing_info数据来看，订阅的试用周期（TRIAL）已完成1个周期，剩余0个周期，但next_billing_time仍指向2025-02-01，说明试用尚未结束，系统还在等待触发常规计费。

正确的API操作方式 #

你之前修改试用阶段total_cycles为0的方法无法达到预期效果——total_cycles是订阅创建时定义的固定总周期数，修改它不会触发系统立即切换计费阶段。正确的做法是使用PayPal订阅更新API（PATCH），通过调整试用周期的剩余次数和下一次计费时间，强制系统提前结束试用并启动常规计费，同时自动触发Webhook事件。

PATCH请求示例

请求地址：https://api-m.paypal.com/v1/subscriptions/{你的订阅ID}
请求方法：PATCH
请求头：需包含有效的PayPal OAuth令牌（Authorization: Bearer {ACCESS_TOKEN}）和Content-Type: application/json
请求体：

[
  {
    "op": "replace",
    "path": "/billing_info/cycle_executions/0/cycles_remaining",
    "value": 0
  },
  {
    "op": "replace",
    "path": "/billing_info/next_billing_time",
    "value": "2024-10-15T12:00:00Z"
  }
]

注意：next_billing_time需设置为当前或未来的UTC时间，设置为当前时间可立即触发常规计费。

效果说明 #

执行上述操作后，PayPal会：

• 立即结束试用周期，切换至常规计费循环
• 自动触发SUBSCRIPTION_UPDATED（订阅已更新）Webhook事件
• 若常规计费扣款成功，还会触发PAYMENT.SALE.COMPLETED（付款完成）Webhook事件

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