如何为买卖双方交易平台集成带卖家入驻的PayPal Multiparty（沙箱环境）

一、资金流向说明 #

PayPal Multiparty（市场商家解决方案）针对交易平台场景提供两种核心资金流转模式：

• 托管模式：买家付款先进入平台专属的PayPal托管账户，待交易履约完成（如买家确认收货）后，平台再将对应资金划转至卖家账户，同时可从中扣除约定服务费。这种模式更适合保障交易双方权益，应对售后纠纷。
• 即时分账模式：买家发起付款时，资金会按预设规则直接拆分，一部分进入卖家账户，另一部分进入平台账户（作为服务费），无需中间托管环节。适合无售后风险或信任度较高的交易场景。

二、沙箱环境实施步骤 #

1. 平台侧基础配置 #

• 注册PayPal沙箱商家账户，申请启用「市场商家（Multiparty）」权限。
• 创建REST API应用，获取沙箱环境的CLIENT_ID和CLIENT_SECRET，用于后续API鉴权。

2. 卖家入驻关联流程 #

• 平台通过PayPal账户链接API生成授权URL，引导卖家跳转至PayPal沙箱登录页，授权平台获取其账户核心信息。
• 授权成功后，平台会拿到卖家的paypal_account_id，将该ID与平台内卖家账号绑定存储。

3. 买家支付流程 #

• 托管模式：调用订单创建API时，仅指定平台账户为收款方，生成支付链接引导买家完成PayPal登录付款。付款完成后资金暂存平台托管账户。
• 即时分账模式：调用订单创建API时，在payment_instruction参数中配置分账规则，指定卖家的paypal_account_id及拆分金额（比如总金额100元，卖家得95元，平台得5元服务费）。
• 买家完成付款后，平台会收到PayPal的webhook通知，用于同步支付状态至平台系统。

4. 资金划转操作 #

• 托管模式：交易确认无误后，调用PayPal转账API，将扣除服务费后的资金从平台账户转至卖家的paypal_account_id。
• 即时分账模式：付款完成后资金自动拆分到对应账户，无需额外操作，可通过API查询分账结果。

5. 沙箱测试验证 #

• 在PayPal沙箱后台创建测试买家、测试卖家、平台商家三类账户。
• 完整走一遍卖家入驻授权、买家支付、资金划转的流程，检查各账户余额变化是否符合预期。
• 验证webhook通知接收是否正常，确保平台能及时响应支付成功、分账完成等关键事件。

三、核心注意事项 #

• 所有资金操作必须通过PayPal官方API完成，禁止引导买家直接转账至卖家账户，否则违反Multiparty合规要求。
• 沙箱环境API调用域名固定为https://api-m.sandbox.paypal.com，生产环境为https://api-m.paypal.com。
• 务必配置并测试webhook，避免因遗漏状态通知导致业务逻辑异常。

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