求助：PayPal合作伙伴推荐链接在浏览器中无法加载

1. 补全请求体必填字段 #

你的请求体缺少PayPal Partner Referrals API要求的关键配置项，这会导致生成的跳转页面因信息不足无法渲染。修改请求体如下：

const createReferal = async () => {
  const paypalApiUrl = 'https://api-m.sandbox.paypal.com/v2/customer/partner-referrals';

  const requestBody = {
    operations: [{ 
      operation: 'API_INTEGRATION',
      api_integration_preference: {
        rest_api_integration: {
          integration_method: 'PAYPAL',
          integration_type: 'THIRD_PARTY',
          third_party_details: {
            features: ['PAYMENT', 'REFUND']
          }
        }
      }
    }],
    legal_consents: [{ type: 'SHARE_DATA_CONSENT', granted: true }],
    products: ['EXPRESS_CHECKOUT'],
    partner_config_override: {
      return_url: 'https://your-mern-app-domain.com/return', // 替换为你的回调URL
      cancel_url: 'https://your-mern-app-domain.com/cancel'  // 替换为你的取消URL
    },
    business_entity: {
      type: 'INDIVIDUAL' // 根据实际入驻类型选择INDIVIDUAL或CORPORATION
    }
  };

  axios.post(paypalApiUrl, requestBody, {
    headers: {
      'Content-Type': 'application/json',
      Authorization: `Bearer {VALID TOKEN GOES HERE}`,
    },
  })
  .then((response) => console.log(response.data))
  .catch((error) => console.log({ error: error.message }));
};

关键补充说明：

• api_integration_preference：指定集成方式与权限，PayPal需要此信息识别你的平台集成类型
• partner_config_override：必填的返回/取消URL，用于跳转后的回调逻辑，缺失会导致页面初始化失败
• business_entity：定义入驻商家的实体类型，是页面渲染的基础信息

2. 验证Token权限范围 #

确保你的Bearer Token包含partner-referrals相关权限。可以通过以下接口验证：

curl -X GET "https://api-m.sandbox.paypal.com/v1/oauth2/token/info" \
-H "Authorization: Bearer YOUR_VALID_TOKEN"

如果返回的权限列表中没有https://uri.paypal.com/services/partner-referrals，需要登录PayPal开发者平台，在你的应用中勾选合作伙伴相关权限，重新生成Token。

3. 确认沙箱账号的合作伙伴身份 #

你的PayPal沙箱账号必须完成合作伙伴注册，普通商家账号无法生成有效的推荐跳转页面。登录PayPal开发者平台，进入账号管理页面，确认合作伙伴状态已激活，若未注册需完成合作伙伴申请流程。

4. 排查浏览器环境问题 #

• 使用无痕模式打开生成的action_url，避免缓存或浏览器扩展干扰
• 打开浏览器控制台（F12），查看是否存在JS加载失败、CORS错误或403/404请求，根据报错信息针对性修复
• 确保浏览器未禁用JavaScript和第三方Cookie，PayPal的入驻页面依赖这些功能

5. 检查推荐数据完整性 #

调用返回结果中的self链接（GET请求，携带相同的Bearer Token），查看推荐数据是否完整：

axios.get('https://api.sandbox.paypal.com/v2/customer/partner-referrals/YzI3ODk0YmUtNTgyYi00MmNmLThiNmItMjBlNTNmMjhkM2UzOWEvc20xZHRhZmUzRS9nTENPYWozOXFpQjVlVmF5WDRubDhoR3Rqb0ZZMD12Mg==', {
  headers: {
    'Authorization': `Bearer {VALID TOKEN GOES HERE}`
  }
})
.then(res => console.log(res.data))
.catch(err => console.error(err))

如果返回的数据缺失business_entity、api_integration_preference等字段，说明请求体配置不完整，回到步骤1补充对应内容。

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