PayPal 集成的坑位清单

PayPal 集成看起来简单，真正花时间的是边界条件。

环境差异

沙箱账号与生产账号完全隔离，凭据不能混用。上线前用生产小额订单跑通全链路，不要只信沙箱。

币种与额度

不同账户支持的币种不同，收款前要确认账户已开通对应币种。用美元金额直接结算人民币会失败或产生高额转换费。

订阅回调

订阅状态通过 webhook 同步，事件类型多且可能重复。用订阅 id 做幂等键，并把激活、暂停、取消映射到本地状态机。

争议与拒付

买家发起争议后，资金会被冻结。要有明确的处理流程和证据留存，否则容易人财两空。