PayPal订单结账API中landing_page设为BILLING时参数无效报错

核心原因 #

landing_page: "BILLING" 参数并非适用于所有支付场景，它仅支持订阅/循环账单类交易，普通一次性支付的/v2/checkout/orders端点不允许使用该值。

解决方案 #

• 场景1：一次性支付
  将experience_context下的landing_page改为"LOGIN"或直接移除该参数（默认值为"NO_PREFERENCE"），示例修正后的请求片段：

  {
    "experience_context": {
      "landing_page": "LOGIN",
      "return_url": "你的回调地址",
      "cancel_url": "你的取消地址"
    }
  }
  

• 场景2：订阅/账单协议
  若你确实需要BILLING落地页（比如创建自动续费订阅），需切换到PayPal订阅API端点（/v1/billing/subscriptions），而非普通订单的/v2/checkout/orders。此时landing_page: "BILLING"参数才会被正常识别。

原请求与响应 #

请求

curl --location 'https://api-m.sandbox.paypal.com/v2/checkout/orders' \
--header 'Content-Type: application/json' \
--header 'PayPal-Request-Id: bdd7e8a2-9f0a-473c-8026-064a259d0fa9' \
--data-raw '{...}'

响应

{"name": "INVALID_REQUEST",...}

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