### [06.02.050 配置Stripe接入](https://guaqi.com/docs/77610)

**Published:** 2026-09-11T02:28:12

**Author:** 二丿小青年

**Excerpt:** 一、这个功能能做什么 Stripe 需要 API 私钥和 Webhook 签名密钥，它们不是同一串值。当前瓜奇…

[06 商品与交易](/docs-archive/1254) / [06.02 支付接入](/docs-archive/1256)

## 一、这个功能能做什么

Stripe 需要 API 私钥和 Webhook 签名密钥，它们不是同一串值。当前瓜奇游客 Stripe 支付要求填写 Webhook 密钥。

### 先认识这几个词

-   **Webhook**：服务在事件发生后主动通知你的网站，例如支付平台通知订单结果。
-   **API 密钥**：访问某项服务的凭据，不是普通显示文字，也不一定是登录密码。
-   **回调**：外部服务在处理后返回信息给网站的过程或入口，例如发送支付结果。

## 二、设置后会有什么效果

可以配置 Stripe 收银台及适用支付方式，并通过回调确认订单。游客支付还需要正确的 Webhook 签名密钥。

## 三、怎么使用

### 第三方准备

在 Stripe 对应测试或正式环境取得 Secret key，填到瓜奇「私钥」。API 密钥类型及环境说明见[Stripe API keys](https://docs.stripe.com/keys)。

在 Webhooks 中添加目标前端的 `/api/callback` 端点，选择 `checkout.session.completed` 和 `checkout.session.async_payment_succeeded`。取得这个端点的 `whsec_` 签名密钥，填写到瓜奇「Webhook 签名密钥」。端点与签名说明见[Stripe Webhooks](https://docs.stripe.com/webhooks)。

### 支付方式

按实际账户支持填写支付方式，多个方式用英文逗号，例如 `card,alipay,wechat_pay`。后台默认列出的方式不代表每个账户、币种和地区都可用。当前流程返回 Checkout 收银台地址，前台使用跳转形式。

### 本地测试

外部 Webhook 无法直接访问仅本机可达的 localhost。需要可达的测试转发入口才能检查通知，且转发工具产生的签名密钥应与当前测试方式匹配。

## 四、常见问题

### 常见报错

配置不完整：检查私钥和支付方式；游客要求 Webhook secret：补对应端点密钥；签名无效：检查端点、环境与密钥匹配。不要通过关闭验签来让错误消失。

浏览器成功回跳与服务器通知分别验证。最终检查订单已确认以及商品、表单或资源确实可用。

### 常见问法与直接答案

#### Stripe 游客支付失败先查什么？

除了 API 密钥、支付方式和货币，还要检查 Webhook 签名密钥及可达的回调。当前游客支付有 Webhook 配置条件。浏览器跳回成功页面不等于服务端已经确认支付。



---