摄入 Webhook 事件

POST/internal/v1/stripe/webhook-eventsInternal

摄入一个已预验证的 Stripe Webhook 事件以进行异步处理。这是一个仅供内部使用的接口，由 Webhook 接收器在签名验证后调用。

鉴权

Auth Chain: Internal — 无需 JWT。此接口仅限内部服务间调用，不通过公共网关暴露。

请求参数

Name	Type	Required	In	Description
eventId	string	Yes	body	Webhook 事件的唯一标识符
connectionBizId	string	Yes	body	接收此事件的 Stripe 连接的业务 ID
stripeEventType	string	Yes	body	Stripe 事件类型（例如 `payment_intent.succeeded`）
occurredAt	long	No	body	事件在 Stripe 中发生的时间戳（epoch 毫秒）
receivedAt	long	No	body	Webhook 接收器收到事件的时间戳（epoch 毫秒）
normalizedPayload	object	No	body	标准化的事件载荷，供内部消费
rawPayload	object	No	body	原始 Stripe 事件载荷

成功响应

成功200

{
  "version": "1.3.0",
  "timestamp": 1709337600000,
  "success": true,
  "code": "2000",
  "message": "SUCCESS",
  "data": "Stripe webhook event accepted"
}

错误响应

Bad Request400

{
  "success": false,
  "code": "4000",
  "message": "Invalid webhook event payload"
}

说明

• 事件在摄入后异步处理；响应仅确认接收。
• 重复的事件 ID 由摄入服务以幂等方式处理。
• 载荷中的未知字段会被静默忽略（@JsonIgnoreProperties）。