PayPal平台费未到合作伙伴账户问题排查求助

沙箱模式下的问题排查 #

沙箱里平台费未到账并非默认正常现象，先排查以下核心点：

• 确认合作伙伴账户类型：必须是PayPal Partner类型账户，而非普通商家/个人账户，沙箱创建账户时需选择对应角色。
• 检查请求凭据：发起订单的API请求必须使用合作伙伴的Client ID/Secret，而非卖家账户的凭据——平台费由合作伙伴收取，需以合作伙伴身份发起交易。
• 验证请求参数：你的订单请求中payment_instruction配置看似正确，但需确认：
  • disbursement_mode设为INSTANT是即时分账的正确配置
  • 平台费金额未超出PayPal规则限制（沙箱中规则宽松，但需确认逻辑合理性）
• 检查沙箱账户状态：确保合作伙伴沙箱账户已完成验证，无限制或异常提示。

若以上都没问题，可在PayPal开发者后台查看沙箱交易详情日志，确认分账环节是否有报错或失败原因。

生产环境平台费到账的保障措施 #

1. 完成正式入驻审核：生产环境必须通过PayPal的Marketplace合作伙伴资质审核，获取分账权限。
2. 使用正确凭据：始终用生产环境合作伙伴API凭据发起包含平台费的订单请求。
3. 确保卖家账户关联：卖家必须通过你的合作伙伴推荐链接完成注册并关联到你的合作伙伴账户下，否则无法分配平台费到你的账户。
4. 遵循PayPal规则：平台费比例、交易类型需符合PayPal官方规则，避免触发风控拦截。
5. 监听Webhook事件：配置监听PAYMENT.CAPTURE.COMPLETED等相关事件，实时确认分账状态，出现失败及时处理。

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