PayPal IPN未传递发票号问题排查：按钮代码已配置但web

PayPal IPN未传递发票号问题排查：按钮代码已配置但web_accept类型交易丢失invoice/custom字段

阿华AIGC实验室

2026-4-30

问题分析与解决方案

首先得给你敲个重点：你现在用的checkout.js是PayPal已经弃用的旧版v4 Checkout SDK，这绝对是你遇到IPN字段缺失问题的核心原因之一，再加上广告拦截工具搞的鬼，才会出现这种奇怪的现象。

为什么会出现txn_type为web_accept且字段丢失？

从你测试的Adblock拦截情况来看，当checkout.js的依赖资源被拦截时，PayPal的按钮会自动降级到传统的web_accept表单提交模式——这不是你配置的Express Checkout流程，而是一个 fallback 方案。在这个降级模式下，你通过JS代码设置的invoice_number和custom字段根本没被传递到PayPal的支付流程里，自然IPN里就拿不到这些值了。而正常加载成功的Express Checkout流程（txn_type为express_checkout）是能正确传递字段的，这也验证了这个逻辑。

解决步骤

1. 立刻切换到最新的PayPal JS SDK

旧的checkout.js已经被PayPal淘汰，不再维护，兼容性问题只会越来越多。新的SDK是https://www.paypal.com/sdk/js，适配现代浏览器，抗拦截能力更强，而且能确保字段正确传递。给你改好的示例代码，直接替换原来的即可：

<script src="https://www.paypal.com/sdk/js?client-id=你的客户端ID"></script>
<script>
  paypal.Buttons({
    style: {
      label: 'checkout',
      fundingicons: true,
      size: 'responsive',
      shape: 'rect',
      color: 'gold'
    },
    createOrder: (data, actions) => {
      return actions.order.create({
        purchase_units: [{
          amount: {
            value: amount, // 确保这个变量在当前作用域有正确值
            currency_code: currency // 同上
          },
          invoice_id: '{$invoice}', // 对应原来的invoice_number
          custom_id: '{$invoice}' // 对应原来的custom字段
        }]
      });
    },
    onApprove: (data, actions) => {
      return actions.order.capture().then(details => {
        // 这里可以加支付成功后的前端逻辑，比如跳转或提示
      });
    }
  }).render('#paypal-button-container'); // 把这个ID改成你页面上的按钮容器ID
</script>

注意：新SDK的API有变化，用createOrder替代了旧的payment.create，字段名也换成了invoice_id和custom_id，别搞错了。