关于PayPal API实现Uber/Airbnb式买家支付流程的技术咨询

你需要用到PayPal Vault API结合Orders API来实现需求，这正是Uber/Airbnb这类平台采用的PayPal集成方案，具体流程如下：

1. 存储买家的PayPal支付方式（授权环节） #

要让买家无需重复跳转PayPal，首先需要获取他们的授权并将PayPal账户信息存储到PayPal Vault中：

• 调用POST /v1/vault/setup-tokens接口创建一个授权令牌（setup token），请求体中指定customer_type: CONSUMER以及你的商家信息。
• 用这个setup token生成PayPal授权按钮（可通过PayPal JS SDK配置vault: true参数），引导买家点击并登录PayPal完成授权。
• 授权成功后，PayPal会返回一个payment_source_id，将这个ID与买家账户关联存储到你的数据库，同时支持买家标记默认支付方式。

2. 管理支付方式（列表、默认设置） #

• 调用GET /v1/vault/payment-sources接口，结合你数据库中存储的买家关联记录，获取所有已存储的PayPal支付方式列表，在应用后台展示给买家。
• 允许买家在应用内设置默认支付方式，你只需在数据库中标记对应的payment_source_id为默认即可，无需调用PayPal API修改。

3. 免跳转一键扣款 #

当买家发起支付时，直接通过Orders API完成扣款：

• 调用POST /v2/checkout/orders创建订单，请求体示例：

  {
    "intent": "CAPTURE",
    "purchase_units": [
      {
        "amount": {
          "currency_code": "USD",
          "value": "10.00"
        }
      }
    ],
    "payment_source": {
      "paypal": {
        "id": "YOUR_STORED_PAYMENT_SOURCE_ID"
      }
    }
  }
  

• 接着调用POST /v2/checkout/orders/{order_id}/capture接口完成扣款，整个过程无需买家跳转PayPal页面，仅需在你的应用内点击支付按钮即可。

关键注意事项 #

• 确保你的PayPal商家账户已启用Vault功能，部分地区可能需要向PayPal提交申请开通。
• 必须在应用内明确告知买家支付方式的存储规则，允许买家随时删除已存储的支付方式，符合PayPal合规要求。
• 处理扣款失败场景：捕获Orders API返回的错误码（如INSUFFICIENT_FUNDS、AUTHORIZATION_EXPIRED），并在应用内给用户对应的提示。

内容的提问来源于stack exchange，提问作者Hichem BEN HAMED