Daiying CMS Stripe 支付插件配置教程：API Key、Webhook 与正式收款完整指南

Stripe 官方支付插件用于把 Daiying CMS 的 Core 支付链路接入 Stripe Checkout，适合发卡、付费内容、付费下载等需要在线收款的场景。当前后台路径为：商业 → 支付管理 → 支付 Provider / 支付方式设置。

前置条件

• Daiying CMS 站点已经启用 official.payment.stripe 插件。
• 已经拥有可用的 Stripe 商户账户。
• 站点域名已经使用 HTTPS，并能被 Stripe Webhook 访问。
• 准备好测试环境或正式环境对应的 Publishable Key、Secret Key、Webhook Signing Secret。

进入 Daiying CMS Stripe 配置页面

在后台左侧进入 商业 → 支付管理，然后点击 支付 Provider，或直接打开 /admin/payments/providers?provider_id=official.payment.stripe#provider-form。页面标题会显示“配置支付方式：Stripe”。

配置 Test Mode

Stripe 的 Test Mode 用于测试订单和支付流程。后台字段名是 Test / Live Mode，测试时选择 Test Mode 测试模式；正式收款前再切换为 Live Mode 正式模式。Publishable Key 与 Secret Key 必须和当前模式匹配，测试模式使用 pk_test_ / sk_test_，正式模式使用 pk_live_ / sk_live_。

填写 API Key

Publishable Key

Publishable Key 是 Stripe 后台 Developers → API keys 中的公开 key。它会保存在公开配置中，可见但不能替代 Secret Key。

Secret Key

Secret Key 是 sk_test_ 或 sk_live_ 开头的私密 key。Daiying CMS 后台以密码输入框保存；如果已经配置，页面只显示“已配置，留空则保留”。不要把 Secret Key 写进高级公共 JSON、文章、截图或聊天记录。

Webhook 配置

Daiying CMS 的 Stripe Webhook 地址为：https://www.daiyingcms.com/payment/webhooks/official.payment.stripe。请在 Stripe Dashboard 的 Webhooks 中创建 Endpoint，并把 Webhook Signing Secret 填入后台的 Webhook Signing Secret 字段。付款成功不能只依赖浏览器回跳，必须通过 Stripe-Signature 验证通过的 Webhook 才会进入 trusted paid。

测试订单与订单状态

保存配置后，在使用 Core 支付的发卡或付费内容场景创建一笔测试订单。支付完成后回到后台 商业 → 支付管理 查看订单状态。支付成功应通过 Webhook 同步为已支付；如果只有浏览器回跳但没有 Webhook，订单不应被直接标记为 trusted paid。

从 Test 切换到 Live

• 在 Stripe 后台切换到 Live 数据。
• 替换为 pk_live_ 和 sk_live_。
• 重新创建正式环境 Webhook Endpoint，并保存 whsec_ 开头的 Webhook Signing Secret。
• Daiying CMS 的 Test / Live Mode 改为 Live Mode 正式模式。
• 用小额真实订单验证创建支付、Webhook 入账和订单状态。

常见错误排查

• Publishable Key 与模式不匹配：检查 pk_test_ / pk_live_ 是否和 Test / Live Mode 一致。
• Secret Key 未配置：Secret Key 留空只会保留已配置值；第一次配置必须填写。
• Webhook Signing Secret 未配置：Stripe 事件无法通过验签，订单不会进入 trusted paid。
• amount_too_small：订单金额低于 Stripe 当前币种最小金额。
• checkout_url_invalid：检查 Checkout Session 返回和支付跳转 URL。

安全注意事项

Secret Key、Webhook Signing Secret 只能保存在后台密钥区，不要放进公开 JSON、文章、客服聊天、截图或 Git。截图教程时应像本文一样只保留“已配置，留空则保留”的状态。

相关阅读

查看 PayPal 支付插件配置教程