如何在Golang中接入Stripe或PayPal支付网关 Go语言国际化支付SDK集成

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 并在对账逻辑里显式处理。