Stripe 配置指南

Stripe 支持信用卡、Apple Pay、Google Pay 等支付方式，适合跨境电商场景。

准备工作

注册 Stripe 账户

访问 stripe.com 注册账户，并完成企业验证。

获取 API 密钥

在 Dashboard -> Developers -> API keys 复制 Publishable key 和 Secret key。

配置 Webhook

在 Developers -> Webhooks 新增回调端点，并复制 Webhook signing secret。

配置步骤

1

步骤一：进入支付平台管理

在管理后台打开支付平台管理，找到 Stripe。

2

步骤二：填写密钥信息

填写 Publishable key（前端使用）、Secret key（后端使用）、Webhook secret。

3

步骤三：配置回调地址

成功 URL：https://yourdomain.com/payment/stripe/success 取消 URL：https://yourdomain.com/payment/stripe/cancel

4

步骤四：选择支付方式

选择要开放的支付方式，如 card（信用卡）、apple_pay、google_pay 等。

5

步骤五：设置货币

设置默认货币代码，如 USD、EUR、GBP 等。

6

步骤六：保存并测试

保存后，用测试密钥和测试卡跑一笔订单。

测试卡号

沙箱环境可使用这些测试卡号：

4242 4242 4242 4242支付成功
4000 0000 0000 3220需要 3D 验证
4000 0000 0000 9995卡片被拒绝

CVV：任意3位数字，过期日期：任意未来日期

注意事项

  • 测试密钥以 sk_test_ 开头，生产密钥以 sk_live_ 开头
  • 生产环境要使用 HTTPS
  • Webhook 端点需要能从公网访问
  • 成功和取消回调地址都要配置

常见问题

如何切换生产环境？

将 test_mode 设为 false，换成生产密钥（sk_live_xxx），回调地址也要改成生产域名。

Webhook 没收到怎么办？

可以先用 Stripe CLI 本地排查：stripe listen --forward-to http://localhost:8080/api/v1/payments/callback/stripe