PayPal Payouts API集成异常：PENDING状态下付款未到账

请求内容 #

{
    "sender_batch_header": {
        "email_subject": "<redacted> Payout Received",
        "email_message": "You have received a payout. Thank you for your service with <redacted>",
        "sender_batch_id": "<redacted-uuid>"
    },
    "items": [{
            "recipient_type": "EMAIL",
            "amount": {
                "value": "100.0",
                "currency": "USD"
            },
            "note": "Thank you for your services",
            "receiver": "<redacted-email>",
            "sender_item_id": "<redacted-uuid>"
        }
    ]
}

响应内容 #

{
    "batch_header": {
        "payout_batch_id": "<redacted-id>",
        "batch_status": "PENDING",
        "sender_batch_header": {
            "sender_batch_id": "<redacted-email>",
            "email_subject": "<redacted> Payout Received",
            "email_message": "You have received a payout. Thank you for your service with <redacted>"
        }
    },
    "links": [{
            "href": "https://api.sandbox.paypal.com/v1/payments/payouts/<redacted-id>",
            "rel": "self",
            "method": "GET",
            "encType": "application/json"
        }
    ]
}

问题排查方向 #

• 沙箱批次需手动触发处理
  沙箱环境下的Payout批次不会自动完成流程。登录发送方的PayPal沙箱账户，找到对应批次，手动操作推进状态（比如批准、完成），之后再检查接收方账户是否到账。

• 接收方沙箱账户未完成验证
  沙箱账户也需要完成基础验证：比如邮箱验证、身份信息填写等。登录接收方的沙箱账户后台，确认所有验证步骤都已完成，否则可能无法接收款项。

• 发送方沙箱账户余额不足
  沙箱账户初始余额有限，确保发送方账户有足够的USD余额覆盖本次100美元的 payout。可以在PayPal沙箱控制台给发送方账户充值对应金额。

• 轮询确认批次最终状态
  用响应中返回的self链接，发起GET请求查询批次的最新状态。PENDING只是初始状态，后续可能因各种原因变为REJECTED或FAILED，通过查询可以获取具体失败原因。

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