PayPal Sandbox测试多商户佣金未到账问题咨询

你提供的订单创建请求体JSON语法本身没有错误，订单可正常审批捕获但佣金未划转的核心原因是platform_fees相关配置未满足PayPal分账规则，参数被系统静默忽略（主交易流程不受影响是这类问题的典型特征），具体问题点和修复方案如下：

核心问题原因 #

• 功能权限未开通：platform_fees是PayPal平台/电商市场解决方案的专属能力，普通沙箱商家账号默认没有该权限。你用来收佣金的账号VZBJPJUECRLUY如果只是普通Business类型沙箱账号，没有在开发者后台开通Marketplace相关能力，请求里的佣金配置会直接被跳过。
• 商户关联关系无效：你配置的两个收款方（merchant_id: YKSAWY4EFUQ9N、P7P8DG5Z9YF54）如果是手动在沙箱后台创建的独立商家账号，没有通过你的平台账号走推荐入驻流程完成授权关联，PayPal不会允许未获授权的第三方从交易中抽取佣金。
• 接口调用身份错误：如果创建订单时使用的Access Token是子商户账号生成的，而非你平台自身App生成的Token，平台方身份无法被识别，佣金配置自然不生效。
• 参数临界值触发拦截：你当前配置的抽成比例刚好是10%（2000USD抽200USD、1000USD抽100USD），沙箱环境默认对未完成资质审核的测试账号开放的抽成上限通常低于10%，临界值配置容易触发静默拦截。

修复步骤 #

• 登录PayPal开发者后台，找到你收佣金的平台沙箱账号对应的App，在功能权限勾选栏中开启「Platform Fees」「Connected Path」「Marketplace Disbursement」相关权限，保存后等待10-15分钟让沙箱权限生效。
• 确认两个收款子商户是通过平台的Referral入驻流程创建、且完成了权限授权，不要使用手动创建的无关联沙箱商家账号做测试。
• 调用创建订单、捕获订单接口时，统一使用你平台自身App的Client ID/Secret生成的Access Token，不要用子商户的凭证发起请求。
• 测试阶段先将payment_instruction.disbursement_mode从INSTANT改为DELAYED，同时把抽成比例调低到5%（比如2000USD订单抽100USD）做验证，捕获成功后调用订单查询接口，若返回结果的purchase_units节点下能看到对应platform_fees的记录，就说明分账配置已经生效，后续再调回目标抽成比例和即时到账模式即可。

注意：沙箱环境本身存在数据同步延迟，权限修改后如果第一次测试仍未到账，可以等待5分钟后重新发起交易测试，不要反复修改配置导致规则冲突。

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