使用PayPal PHP SDK授权支付时遇400金额验证错误

我刚踩过类似的坑，来帮你把问题捋明白！

核心问题：PayPal不识别details里的fee字段 #

你在amount.details里传入了fee字段，但PayPal的交易明细规则中，只认可subtotal、tax、shipping、handling、insurance这几个官方字段，fee不在允许的明细列表里。这就导致PayPal验证时，只会计算它认可的明细总和（也就是你的subtotal：600.00GBP），而你设置的total是675.00GBP，两者不匹配，直接触发了VALIDATION_ERROR。

关于number_format的疑问 #

先给你吃个定心丸：$grandTotal = number_format($data['job']['grandTotalAmount'], 2, '.', '')这段代码本身没问题，它会正确输出保留两位小数的金额字符串（比如675会变成'675.00'）。除非你的原始grandTotalAmount是有精度问题的浮点数（比如674.9999999999），但你说数值相加无误，所以这个函数不是问题根源。

解决方案 #

根据你的业务场景，你可以选以下两种方式调整参数：

1. 将手续费合并到subtotal中

如果这个75GBP是你自己收取的手续费，不需要单独展示给用户，直接把它加到subtotal里：

$details = new Details();
$details->setSubtotal('675.00'); // 600+75合并后的金额
$amount->setDetails($details);

$amount->setCurrency('GBP');
$amount->setTotal('675.00');

2. 将手续费作为单独商品项加入item_list

如果需要把手续费单独展示给用户，把它做成一个独立的item放在item_list里，这样PayPal会自动计算所有item的总价和total匹配：

// 主商品项
$mainItem = new Item();
$mainItem->setName('你的服务名称')
         ->setCurrency('GBP')
         ->setQuantity(1)
         ->setPrice('600.00');

// 手续费项
$feeItem = new Item();
$feeItem->setName('服务手续费')
        ->setCurrency('GBP')
        ->setQuantity(1)
        ->setPrice('75.00');

$itemList = new ItemList();
$itemList->setItems([$mainItem, $feeItem]);

// 设置金额
$amount = new Amount();
$amount->setCurrency('GBP');
$amount->setTotal('675.00');

// 如果不需要单独展示明细，details可以省略；如果要展示，subtotal设为所有item的总价675.00
$details = new Details();
$details->setSubtotal('675.00');
$amount->setDetails($details);

额外注意点 #

• 确保所有金额都是字符串类型，并且严格保留两位小数，避免浮点数精度问题（比如不要直接传675，要传'675.00'）。
• 如果你的fee是PayPal官方收取的手续费，完全不需要在交易参数里体现，PayPal会自动从交易金额中扣除，不需要你手动添加。

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