Node.js使用Paypal REST SDK返回400 VALIDATION_ERROR错误求助

该400 VALIDATION_ERROR是Paypal接口的金额一致性校验不通过导致的，核心规则为：购物车内所有商品的「单价*数量」求和结果，必须和提交的订单总金额完全匹配；如果请求体中携带了item_list参数，还需要显式声明金额明细中的subtotal字段完成校验。

• 对比校验两边金额总和：本地同时打印cart.totalPrice，以及getItems返回的所有商品的price * quantity求和结果，确认两者数值完全相等，注意规避JS浮点数精度问题（例如9.99 * 3在JS运算中会得到29.970000000000002，和直接存储的29.97会被判定为不相等）。
• 检查金额格式合规性：Paypal要求所有金额必须为保留两位小数的字符串类型，不能是数字类型，也不能只有1位小数或者整数，例如总金额为5美元时，必须传"5.00"，不能传5或者"5"，单个商品的price字段也需要符合该要求。
• 检查请求体结构完整性：你当前的代码只在amount下传了total字段，没有补充details下的subtotal字段，也是触发该校验错误的高频原因。

1. 修改getItems工具函数，统一商品金额格式 #

function getItems(cart) {
    let itemsArray = [];
    for (const [idx, item] of Object.entries(cart)) {
      itemsArray.push({
                "name": item.item.product_name, 
                "price": (Number(item.price)).toFixed(2), // 统一转为两位小数的字符串
                "currency": "USD",
                "quantity": item.qty.toString() // 数量也建议传字符串格式避免格式校验问题
            });
    }
    return itemsArray;
}

2. 修改/pay路由的支付请求体，补充金额明细结构 #

app.post('/pay' , (req , res) => {
    let cart = new Cart(req.session.cart)
    const items = getItems(cart.items)
    // 提前计算商品总金额作为subtotal
    const subtotal = items.reduce((sum, item) => sum + Number(item.price) * Number(item.quantity), 0).toFixed(2)
    
    const create_payment_json = {
    "intent": "sale",
    "payer": {
        "payment_method": "paypal"
    },
    "redirect_urls": {
        "return_url": "http://localhost:3000/success",
        "cancel_url": "http://localhost:3000/failed"
    },
    "transactions": [{
        "item_list": {
            "items": items
        },
        "amount": {
            "currency": "USD",
            "total": (Number(cart.totalPrice)).toFixed(2), // 总金额也统一格式
            "details": {
                "subtotal": subtotal
                // 如果有税费、运费、折扣，可以在此处补充对应字段，需保证 total = subtotal + tax + shipping - discount 等式完全成立
            }
        },
        "description": "This is the payment description."
    }]
};
// 剩余原有逻辑不变
})

额外注意 #

如果订单存在满减、优惠券等抵扣场景，需要在amount.details中新增discount字段，保证总金额的计算等式完全符合Paypal的校验规则，避免再次触发同类型错误。

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