模拟 Stripe webhook 负载
一个 GET 模拟数据,返回一个 Stripe 格式的 payment_intent.succeeded 事件,随时可将其送入您的 webhook 处理程序中。
此模板为您提供一个有效的 URL,该 URL 返回一个 Stripe 格式的 payment_intent.succeeded 事件,因此您可以构建和调试 webhook 处理程序而无需触发真实支付。将您的处理程序指向该 URL,或将负载直接复制到测试夹具中。它重现了事件的结构,而不是 Stripe 的签名 — 所以它是用于解析逻辑的正确工具,但不适合用来验证 Stripe-Signature。
返回一个现成的事件 — 将其直接提供给您自己的处理程序。
响应负载
{
"id": "evt_1QsErTLl2dK9Nqi7",
"object": "event",
"type": "payment_intent.succeeded",
"created": {{now.unix}},
"data": {
"object": {
"id": "pi_3QsErTLl2dK9Nqi71m2XvBnR",
"object": "payment_intent",
"amount": 4999,
"currency": "usd",
"status": "succeeded"
}
}
}
值得了解的字段
| 字段 | 含义 |
|---|---|
| id | 合成事件 ID —— Stripe 真实的 ID 遵循相同的 evt_... 格式,但从不重复使用。 |
| type | 您的处理程序依赖的事件类型;更改它以触发不同的代码路径。 |
| created | 事件的 Unix 时间戳,每次调用时通过 {{now.unix}} 全新生成。 |
| data.object.amount | 以最小单位(美分)表示的收费金额 —— 4999 表示 49.99 美元。 |
| data.object.status | payment_intent 状态;编辑响应正文以测试其他状态,如 requires_action。 |
创建模拟数据
curl -X POST https://quickmock.dev/api/mocks \
-H 'Content-Type: application/json' \
-d '{
"method": "GET",
"response_status": 200,
"content_type": "application/json",
"response_body": "{\"id\":\"evt_1QsErTLl2dK9Nqi7\",\"object\":\"event\",\"type\":\"payment_intent.succeeded\",\"created\":{{now.unix}},\"data\":{\"object\":{\"id\":\"pi_3QsErTLl2dK9Nqi71m2XvBnR\",\"object\":\"payment_intent\",\"amount\":4999,\"currency\":\"usd\",\"status\":\"succeeded\"}}}"
}'
调用它
curl https://quickmock.dev/m/<slug>
您将获得什么
GET /m/<slug> -> 200 a Stripe-style payment_intent.succeeded event
data.object.amount is in minor units (cents)
这与真实情况有何不同
这是一个从真实的 Stripe 负载中缩减而来的静态事件 — 没有 Stripe-Signature 请求头,ID 背后没有真实的活动对象。使用它来塑造处理程序的解析逻辑,而不是用来测试签名验证。
来源
- Stripe: the payment_intent.succeeded event
- Stripe: webhook endpoints and delivery
- Stripe: verifying webhook signatures
常见问题解答
- 这是真实的 Stripe API 吗?
- 不。这是从真实的 Stripe 负载中裁剪出来的静态事件,并通过您自己的模拟 URL 提供。ID 是合成的,它们背后没有任何东西 —— 没有扣款,没有客户,没有可获取的实时对象。
- 我可以用它测试签名验证吗?
- 不行,这是故意的。这里没有 Stripe-Signature 标头,因为生成它需要 Stripe 的签名密钥。请针对 Stripe 自己的 CLI 测试验证;在签名检查通过后使用此功能进行所有其他测试。
- 如何测试不同的事件类型?
- 编辑响应正文并更改 type 字段,以及新事件在 data.object 下携带的任何内容。这是执行您在 Stripe 测试模式下无法轻易触发的处理程序分支的最快方法。
准备好使用了吗?
与本指南非常搭配: 测试 Webhook 接收器
相关模板
最后更新: 2026-10-17