模拟 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 API 吗?
不。这是从真实的 Stripe 负载中裁剪出来的静态事件,并通过您自己的模拟 URL 提供。ID 是合成的,它们背后没有任何东西 —— 没有扣款,没有客户,没有可获取的实时对象。
我可以用它测试签名验证吗?
不行,这是故意的。这里没有 Stripe-Signature 标头,因为生成它需要 Stripe 的签名密钥。请针对 Stripe 自己的 CLI 测试验证;在签名检查通过后使用此功能进行所有其他测试。
如何测试不同的事件类型?
编辑响应正文并更改 type 字段,以及新事件在 data.object 下携带的任何内容。这是执行您在 Stripe 测试模式下无法轻易触发的处理程序分支的最快方法。

准备好使用了吗?

在模拟构建器中打开以先进行调整

与本指南非常搭配: 测试 Webhook 接收器

相关模板

← 所有模板

最后更新: 2026-10-17