PayPal多方卖家集成问题：API响应缺失oauth_third_party参数

以下是针对你遇到的API响应缺少oauth_integrations.oauth_third_party参数的排查和解决步骤：

• 检查partner-referrals API的请求参数
  生成商家注册链接时，必须在operations数组的api_integration_preference中完整配置OAuth相关信息，否则后续merchant-integrations API不会返回对应参数。核心配置示例（PHP）：

  $partnerReferralPayload = [
      "operations" => [
          [
              "operation" => "API_INTEGRATION",
              "api_integration_preference" => [
                  "rest_api_integration" => [
                      "integration_method" => "PAYPAL",
                      "integration_type" => "THIRD_PARTY",
                      "oauth_integration" => [
                          "scopes" => [
                              "https://uri.paypal.com/services/payments/realtimepayment",
                              "https://uri.paypal.com/services/subscriptions"
                          ],
                          "return_url" => "https://your-domain.com/paypal-oauth-callback"
                      ]
                  ]
              ]
          ]
      ],
      // 补充business_details、legal_business_entity等必填商家信息
  ];
  

  重点确认integration_type设为THIRD_PARTY，且scopes包含你业务所需的权限。

• 验证商家入驻流程完整性
  确保商家通过你生成的partner-referrals链接完成了全流程入驻，包括OAuth授权环节。如果商家在入驻过程中跳过了授权步骤，PayPal不会生成oauth_third_party相关数据。沙箱环境下可以用测试商家账号重新走一遍流程，确认授权页面的同意操作已完成。

• 检查PayPal应用配置
  登录PayPal开发者平台，进入你的沙箱应用：

  • 确认应用类型设置为Platform（多方卖家场景必须）；
  • 启用第三方OAuth权限，并添加所有你在partner-referrals中指定的scopes对应的权限项。

• 确认API访问令牌权限
  调用merchant-integrations API时，使用的访问令牌必须包含partner_merchant_integrations_read权限。可以通过解码JWT令牌验证权限范围，生成令牌时要确保请求的scope包含https://uri.paypal.com/services/partner/merchant/read。

• 沙箱环境同步延迟处理
  沙箱环境偶尔会有数据同步延迟，商家完成入驻后等待5-10分钟再调用接口，避免因数据未同步导致参数缺失。也可以直接用PayPal开发者平台的API Explorer调用该接口，排除代码层面的请求构造问题。

内容的提问来源于stack exchange，提问作者Arslan Ahmed Awan