如何获取PayPal merchant-id？API V2后续操作及版本选择咨询

获取merchant_id的两种可靠方式 #

1. 通过Webhook接收入驻完成事件 #

调用https://api-m.sandbox.paypal.com/v2/customer/partner-referrals时，在请求体中添加Webhook配置：

{
  "preferred_notification_method": "WEBHOOK",
  "webhook_url": "你的Webhook端点URL",
  // 其他原有配置...
}

商家完成入驻流程后，PayPal会向你指定的Webhook端点发送PARTNER_MERCHANT_ONBOARDING_COMPLETED事件，事件的payload中会包含merchant_id字段，你可以将其关联到用户数据库。

2. 通过return_url的Query参数获取 #

在调用partner-referrals API时，设置return_url参数：

{
  "return_url": "你的回调页面URL",
  // 其他原有配置...
}

商家完成入驻后会跳转至该URL，PayPal会在URL的Query参数中携带merchant_id，你可以从前端或后端解析这个参数并关联到用户数据库。注意：此方式适合快速测试，生产环境优先用Webhook，避免用户中途关闭页面导致无法获取。

API版本问题 #

不需要切换至V1。V2的Partner Referrals API完全支持商家入驻的全流程，后续向商家付款时，使用V2的/v2/payments/payouts API即可直接使用获取到的merchant_id进行操作。

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