如何在Node.js的PayPal支付创建路由中配置客户承担交易手续费？

我已编写Node.js路由用于在执行支付前创建支付订单，现需配置支付设置，让客户承担交易手续费。例如商品标价5美元，卖家实收4.34美元，0.66美元的手续费由客户支付，请问该如何实现？

实现思路 #

核心逻辑是将PayPal交易手续费加到买家支付的总金额中，同时通过API明确拆分费用构成，确保卖家实收金额为商品标价（扣除手续费后的净额）。具体操作如下：

• 计算买家需支付的总金额：商品标价 + 预估的PayPal手续费
• 在支付订单中拆分金额明细，让买家和PayPal清晰看到费用构成
• 配置卖家实收规则，指定手续费由买家承担

修改后的代码示例 #

paypal.payment.create(
    {
        intent: "sale",
        payer: {
            payment_method: "paypal",
        },
        redirect_urls: {
            return_url: returnUrl,
            cancel_url: cancelUrl,
        },
        transactions: [
            {
                amount: {
                    total: "5.66", // 买家实际支付总金额：5美元商品价 + 0.66美元手续费
                    currency: "USD",
                    details: {
                        subtotal: "5.00", // 商品标价
                        fee: "0.66" // 由买家承担的PayPal手续费
                    }
                },
                description: "商品描述内容",
                payment_options: {
                    seller_payable_breakdown: {
                        paypal_fee: {
                            currency: "USD",
                            value: "0.66"
                        },
                        net_amount: {
                            currency: "USD",
                            value: "5.00" // 卖家最终实收金额
                        }
                    }
                }
            }
        ],
    },
    function (error, payment) {
        if (error) {
            console.dir(error.response.details);
            return res
                .status(500)
                .json({ error: "Unable to create PayPal payment" });
        } else {
            console.log("Create Payment Response");
            console.log(payment);
            // 跳转至PayPal授权页面
            const approvalUrl = payment.links.find(
                (link) => link.rel === "approval_url"
            ).href;
            res.json({ approvalUrl: approvalUrl });
        }
    }
);

注意事项 #

• 手续费计算：PayPal手续费通常为2.9% + 0.30美元/笔，可根据商品价格提前计算准确金额，避免误差
• 买家告知义务：需在前端页面明确告知买家需承担的手续费金额，避免交易纠纷
• API版本兼容：上述代码基于PayPal v1 REST API，若使用v2 API（orders.create），字段结构略有不同但逻辑一致

内容的提问来源于stack exchange，提问作者Khang Nguyễn