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