PayPal集成突发报错：收款方与预期商户ID不匹配问题求助

问题背景 #

我们运营的多商户电商平台使用PayPal集成服务已两年，此前仅需卖家提供PayPal账户邮箱即可完成配置：

• 结账环节加载SDK的原配置：

  <script src="https://www.paypal.com/sdk/js?client-id=ABC_123_XYZ&merchant-id=seller@example.com&currency=USD&commit=false&locale=en_US&intent=authorize"></script>
  

  其中ABC_123_XYZ是平台在PayPal开发者平台的API客户端ID，seller@example.com为卖家的PayPal账户邮箱。
• 同时在设置purchase_units时配置：

  'payee': { 'email': 'seller@example.com' }
  

该配置一直运行正常，直至2025年3月21日突发报错。

报错信息 #

Error: Payee(s) passed in transaction does not match expected merchant id. Please ensure you are passing merchant-id=XXXXXXXXXXXXX or merchant-id=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX to the sdk url. https://developer.paypal.com/docs/checkout/reference/customize-sdk/

目前使用报错信息中的商户ID替换邮箱配置SDK可恢复正常，但要求所有卖家突然提供商户ID操作繁琐。

问题原因分析 #

1. PayPal API规则变更：PayPal在2025年3月21日左右调整了多商户场景下的身份校验逻辑，彻底移除了通过卖家邮箱作为merchant-id参数传入SDK的兼容机制，强制要求使用卖家账户对应的唯一商户ID（即报错信息中给出的一串字符）完成身份匹配。
2. 参数校验严格化：原配置中，SDK的merchant-id与purchase_units的payee.email均使用邮箱，PayPal此前会自动关联邮箱对应的商户ID完成校验；现在要求merchant-id必须直接传入官方分配的商户ID，否则触发校验不通过报错。

解决方案建议 #

方案1：批量收集卖家商户ID（短期过渡） #

• 通知卖家登录PayPal商家后台，在「账户设置-业务信息」中找到自身的商户ID（通常为13位或更长的字符），提交给平台更新配置。
• 平台可提供简易操作指引（如步骤截图）降低卖家操作门槛，优先处理活跃卖家的配置更新，减少对业务的影响。

方案2：API自动获取商户ID（长期最优） #

• 利用PayPal商户信息查询API，在卖家提交邮箱后，平台后台自动调用API获取对应的商户ID，无需卖家手动提供：
  • 前提：平台需在PayPal开发者平台配置具备账户信息查询权限的应用；
  • 逻辑：卖家绑定邮箱时，后台向PayPal发起请求，传入卖家邮箱，返回对应商户ID后自动存储，用于SDK和purchase_units的配置。

方案3：临时兼容处理（应急） #

• 若部分卖家暂时无法提供商户ID，可尝试移除SDK中的merchant-id参数，仅保留client-id，同时确保purchase_units中的payee.email准确。但此方法存在兼容性风险，需先在测试环境验证，且PayPal后续可能彻底关闭邮箱校验的兼容通道，仅作为临时应急手段。

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