PayPal沙箱新建recurring订阅 审批页总金额显示为0（预设100PLN）

测试场景说明 #

• 测试环境：PayPal沙箱
• 测试流程：验证新建定期付款（recurring payment）订阅的全链路流程
• 调用的创建订阅接口端点：https://api.sandbox.paypal.com/v1/billing/subscriptions
• 接口请求体参数：

{
  "plan_id": "P-9JP75835703395314MA2P3FQ",
  "start_time": "2021-03-04T20:00:00Z",
  "subscriber": {
    "name": {
      "given_name": "John",
      "surname": "Doe"
    },
    "email_address": "customer@example.com"
  },
  "application_context": {
    "brand_name": "example",
    "locale": "en-US",
    "shipping_preference": "SET_PROVIDED_ADDRESS",
    "user_action": "SUBSCRIBE_NOW",
    "payment_method": {
      "payer_selected": "PAYPAL",
      "payee_preferred": "IMMEDIATE_PAYMENT_REQUIRED"
    },
    "return_url": "https://example.com/returnUrl",
    "cancel_url": "https://example.com/cancelUrl"
  }
}

• 预期订阅规则：定期扣费金额设置为100 PLN
• 实际异常表现：完成订阅创建跳转到审批环节时，页面购物车图标旁显示的总金额为0，审批效果可参考实测页面截图

金额显示为0的常见诱因 #

• 关联计划的计费阶段配置错位：PayPal审批页仅展示用户完成授权时需要即时扣除的金额，如果绑定的plan_id将首个计费阶段设置为0元免费试用，100 PLN的正式扣费规则配置在后续计费周期，审批页即时金额栏就会显示为0
• 首次扣费节点设置偏差：如果订阅的start_time远晚于当前时间，审批页不会预渲染后续周期的扣费金额，仅展示即时应扣的0元金额
• 计划配置缓存未同步：修改订阅计划的金额规则后，未生成新的plan_id，直接沿用修改前的旧计划ID创建订阅，沙箱侧仍读取旧计划的0金额缓存
• 计费阶段的货币配置错误：如果计划内的PLN金额配置存在格式错误、多币种规则冲突，沙箱无法识别对应金额，会默认在审批页展示为0

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