如何创建PayPal自定义结账页面及处理订阅支付税费问题

1. 如何创建支持自定义金额单次付款与定期付款的PayPal自定义结账页面？ #

• 单次付款：基于PayPal Orders API配合JS SDK实现

  1. 前端加载PayPal JS SDK，初始化结账按钮时，通过createOrder回调获取用户输入的自定义金额，动态传入订单创建请求。
  2. 后端调用Orders API创建订单，将purchase_units[0].amount.value设为用户自定义金额，返回订单ID给前端启动结账流程。
  3. 用户完成付款后，后端调用capture接口确认收款状态。
     前端核心代码示例：

  paypal.Buttons({
    createOrder: function(data, actions) {
      const customAmount = document.getElementById('custom-amount').value;
      return actions.order.create({
        purchase_units: [{
          amount: { value: customAmount, currency_code: 'USD' }
        }]
      });
    },
    onApprove: function(data, actions) {
      return actions.order.capture().then(details => {
        // 处理付款成功逻辑
      });
    }
  }).render('#paypal-single-button');
  

• 定期付款（订阅）：基于PayPal Subscriptions API实现

  1. 先通过商家后台或API创建支持自定义金额的订阅计划，开启金额可配置选项。
  2. 前端加载JS SDK，初始化订阅按钮，在createSubscription回调中传入计划ID，并动态覆盖金额参数。
  3. 用户完成授权后，通过Webhook接收订阅成功事件，后续扣款由PayPal自动执行。
     前端核心代码示例：

  paypal.Buttons({
    createSubscription: function(data, actions) {
      const customSubAmount = document.getElementById('custom-sub-amount').value;
      return actions.subscription.create({
        plan_id: '你的订阅计划ID',
        plan: {
          billing_cycles: [{
            pricing_scheme: {
              fixed_price: { value: customSubAmount, currency_code: 'USD' }
            }
          }]
        }
      });
    },
    onApprove: function(data) {
      // 处理订阅成功逻辑
    }
  }).render('#paypal-sub-button');
  

2. 自定义金额付款时，如何在PayPal结账页添加销售税、总金额等字段？ #

在创建订单的API请求中，通过purchase_units[0].amount.breakdown定义明细项，PayPal结账页会自动展示税费、商品总价等字段，并计算最终总金额。
后端订单创建请求参数示例：

{
  "intent": "CAPTURE",
  "purchase_units": [
    {
      "amount": {
        "value": "110.00",
        "currency_code": "USD",
        "breakdown": {
          "item_total": { "value": "100.00" },
          "tax_total": { "value": "10.00" }
        }
      },
      "items": [
        {
          "name": "自定义商品",
          "unit_amount": { "value": "100.00", "currency_code": "USD" },
          "quantity": "1"
        }
      ]
    }
  ]
}

• 需确保总金额value等于item_total+tax_total（若有运费可添加shipping字段），PayPal会自动校验并展示明细。

3. 订阅支付相关问题 #

3.1 能否为每笔订阅付款添加销售税？ #

可以，两种实现方式：

• 计划层面设置：创建订阅计划时，在tax字段定义税率或固定税额，该计划下所有订阅都会自动应用税费。
• 单个订阅动态设置：调用createSubscription接口时，单独为该订阅配置tax参数，覆盖计划默认设置。
  示例计划中税费配置：

{
  "plan": {
    "tax": {
      "percentage": "7",
      "inclusive": false
    }
  }
}

• percentage为税率，inclusive设为false表示税费额外计算，true表示已包含在订阅金额中。

3.2 更新销售税率后，新税率是否适用于现有订阅用户？ #

默认情况下，新税率仅适用于新订阅，现有订阅会沿用创建时的税率。
若要让现有订阅应用新税率，需手动操作：

1. 修改订阅计划税率时，选择“立即应用于现有订阅”（商家后台），或通过updatePlan接口设置apply_to为EXISTING_SUBSCRIPTIONS。
2. 针对单个现有订阅，调用updateSubscription接口单独更新其税率配置。

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