PayPal 集成（ShipAny Next 与 Two）
在 ShipAny Next 和 ShipAny Two 中接入 PayPal——商家账号、沙盒测试、Webhook 校验和支付回调；以及目前哪些版本支持 PayPal。
最后更新: 2026年10月8日
对很多海外买家来说，PayPal 仍然是首选的付款方式。ShipAny Next 和 ShipAny Two 内置了开箱即用的 PayPal 渠道，支持一次性付款和订阅（Webhook 地址 /api/payment/notify/paypal）。ShipAny TanStack 中 PayPal 配置项已预留，但渠道还没有启用——目前请使用 Stripe 或 Creem。
ShipAny 帮你做了什么
- PayPal 结账：用户在支付方式弹窗中选择 PayPal，跳转到 PayPal 完成付款。
- 沙盒与正式环境：在管理后台切换。
- Webhook 校验：用 PayPal Webhook ID 校验通知，只有真实的支付通知才会更新订单。
- 回调跳转：在 ShipAny Two 中，一次性付款回到
/settings/payments，订阅回到/settings/billing（可在下单接口中修改）。
配置步骤
- 注册 PayPal 商家账号。
- 在 PayPal 开发者后台的 API Credentials 中复制 Client ID 和 Secret——测试时用沙盒凭证，上线用正式凭证。
- 在 ShipAny 管理后台打开 设置 → 支付 → PayPal，填入 Client ID 和 Secret，Webhook ID 可以先留空。
- 在 Testing Tools → Sandbox Accounts 中用沙盒买家账号，从
/pricing页面下单测试。 - 在 PayPal 后台为你的域名创建 Webhook，把 Webhook ID 填回管理后台。
注意事项
- 不要只依赖同步回调：用户付款后如果没等跳转就关闭页面，只有 Webhook 能完成订单——一定要配置。
- 上线时沙盒和正式凭证一起切换。