如何使用PayPal API实现转账时由收款方承担手续费（PHP开发场景）

PayPal Payouts API默认由转账发起方承担手续费用，你可以通过调整请求参数的方式指定手续费由收款方承担，具体调整方案如下：

1. 核心参数配置 #

调用Payouts接口构造请求体时，在转账项参数中新增payer字段，赋值为RECEIVER即可指定该笔转账的手续费由收款方承担。
注意：该配置生效的前提是你方及收款方的PayPal商户账户均支持收款方承担手续费的权限，可登录PayPal商户后台费用设置页面确认权限是否开通。

2. PHP代码示例（基于官方Payouts SDK） #

如果你使用PayPal官方的paypal/payouts-sdk扩展包，可参考以下构造请求的代码：

// 初始化请求对象
$payoutsRequest = new \PayPal\Payouts\PayoutsPostRequest();

// 构造请求体
$requestBody = [
    "sender_batch_header" => [
        "sender_batch_id" => "PAYOUT_BATCH_" . uniqid(),
        "email_subject" => "您的商户结算款项已到账"
    ],
    "items" => [
        [
            "recipient_type" => "EMAIL",
            "amount" => [
                "value" => "150.00",
                "currency" => "USD"
            ],
            "receiver" => "seller@example.com",
            "sender_item_id" => "SETTLE_" . date("Ymd") . "_" . uniqid(),
            // 核心参数：指定手续费由收款方承担
            "payer" => "RECEIVER"
        ]
    ]
];
$payoutsRequest->body = $requestBody;

// 执行请求逻辑省略

如果是批量转账，你可以在每一个items子项中分别添加该参数，实现单批次不同转账项的手续费规则差异化配置。

3. 注意事项 #

• 手续费会直接从收款方的到账金额中扣除，你需要提前在商户结算规则中明确告知卖家手续费扣除逻辑，避免后续出现对账纠纷
• 若收款方账户不支持收款方承担手续费，接口会返回对应错误码，你可以在请求回调中捕获该异常，可选择 fallback 为发起方承担手续费的逻辑，或者终止转账并通知卖家调整账户权限
• 该配置仅对PayPal账户间转账生效，若收款方使用其他收款方式可能不支持该参数，调用前建议先做账户适配校验

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