Stripe官方Go SDK是唯一推荐方式，PayPal仅支持v1或v2 SDK且不兼容；双网关Webhook须物理隔离路由，验签、响应格式及时钟容忍度均不同；金额单位、币种大小写、无小数货币校验等需严格遵循规范。
Stripe 官方 Go SDK 是唯一推荐接入方式
Stripe 没有第三方维护的“多网关抽象层”，强行封装 stripe-go 和 PayPal SDK 到一个接口里，只会增加空转逻辑和错误归因成本。官方 SDK 更新及时、文档精准、Webhook 验证完整，直接用它最省心。
常见错误现象：signature verification failed（Webhook 签名验签失败）、Invalid API Key（测试 key 误用于生产环境）、Amount must be positive（传了 float64 或字符串金额）。这些几乎都源于绕过 SDK 自带工具函数，手写 HTTP 请求或自己解析 JSON。
- 始终用
stripe.ParseWebhookEvent解析 Webhook，别用json.Unmarshal直接解 - 金额单位必须是整数分（如 $19.99 → 1999），且类型为
int64；传float64(19.99)会触发精度截断 - 测试环境用
sk_test_...+whsec_...，生产环境换 key 后，务必同步更新 Webhook signing secret，否则验签必挂
PayPal 的 Go 客户端只能选 paypal（v1）或 paypal-checkout-serversdk-go（v2）
PayPal 没有类似 Stripe 那样统一、活跃维护的 Go SDK。目前只有两个选择：社区维护的 paypal（基于老版 REST v1）和 PayPal 官方的 paypal-checkout-serversdk-go（v2，仅支持 Checkout 流程）。两者不兼容，也不能混用。
使用场景差异明显：如果你要接“一键支付”（Buy Now）、订阅（Billing Plans）、发票（Invoicing），v1 SDK 还能凑合；但要做“无跳转结账”（Vault + Orders v2）或需要 PCI DSS 合规免托管卡号，必须用 v2 SDK。
立即学习“go语言免费学习笔记（深入）”；
- v1 SDK 的
DoCapture返回结构不稳定，字段名常变（比如Amount→amount），建议用 map 解析而非 struct 绑定 - v2 SDK 要求显式调用
client.CaptureOrder，不能靠 webhook 自动完成资金转移；漏掉这步，订单永远卡在 “APPROVED” - PayPal sandbox 的 webhook endpoint 必须是 HTTPS 且可公网访问（本地开发得配 ngrok），而 Stripe 的 webhook 可以先用
stripe-cli listen本地调试
双网关共存时，Webhook 路由必须物理隔离
别试图用同一个 HTTP handler 同时处理 Stripe 和 PayPal 的 webhook。它们签名机制、时间戳格式、重放攻击防护逻辑完全不同，混在一起只会让验证逻辑越来越脆弱。
正确做法是用不同 path 分离：比如 /webhook/stripe 和 /webhook/paypal，各自独立解析、验签、响应。哪怕业务逻辑最终都调用同一个 UpdateOrderStatus 函数，前置校验也绝不能共享。
- Stripe webhook 响应必须是 200，且 body 为空；返回任何非空 body（比如
{"ok": true}）会导致重试 - PayPal webhook 响应必须是 200，且 header 中含
Content-Type: application/json；少这个 header，PayPal 会认为失败并重发 - 两者的时间戳容忍窗口不同：Stripe 默认允许 5 分钟偏移，PayPal 要求严格 ≤ 5 秒；服务器时间不准会直接导致验签失败
货币与语言不是 SDK 控制的，是前端+API 协同决定的
Go 后端 SDK 不处理界面语言切换，也不做货币格式化。所谓“国际化支付”，实际是：前端根据用户 locale 渲染对应语言按钮 + 传入正确 currency code（如 USD、JPY），后端只负责把该 currency 透传给 Stripe/PayPal，并确保金额数值按该币种规则计算（例如 JPY 不含小数位）。
容易踩的坑在于：前端传 currency=usd，后端却用 1999 当作 USD 处理，而用户其实是日元场景——Stripe 会拒单，PayPal 则可能静默转成 USD 结算，后续对账全乱。
- 所有 currency code 必须大写（
USD），小写（usd）在 PayPal v2 中会被拒绝 - JPY、KRW、VND 等无小数货币，金额必须为整数，且后端需校验前端传来的
amount是否已舍去小数（math.Floor不够，得用int64(amount * 100)再判断是否整除 100） - 不要在 Go 后端用
golang.org/x/text/message格式化金额返回给前端——格式化应由前端用Intl.NumberFormat完成，后端只传原始数字和 currency code
最麻烦的其实是时区和夏令时：Webhook 时间戳是 UTC，但某些国家的结算周期按本地日历算。别指望 SDK 帮你转换，得自己存用户 timezone 并在对账逻辑里显式处理。
