如需查看完整的 Schema 衍生目录,请参阅所有示例。
概述
处理 WhatsApp 支付状态更新。准备工作
- 在您的应用程序中创建一个公开的 HTTPS 端点。
- 为您所需的事件类型配置 YCloud Webhook 端点。
- 安全存储端点签名密钥。
- 确保事件处理具有幂等性。
工作原理
事件发生时,YCloud 会发送 HTTPPOST 请求。验证签名,持久化记录事件,返回 2xx 响应,并异步处理耗时任务。
请求
以下场景展示了发送到您的 Webhook URL 的请求。将事件id 视为传递标识符,并使用 type 路由有效负载。
响应
接收事件后返回2xx 状态。
有关端点设置、签名验证和重试机制的更多信息,请参阅配置 Webhook。
支付交易已更新
当用户发起的交易状态发生变更时,您将通过 Webhook 收到更新。这会在支付状态更改为captured(支付成功完成)或 pending(用户已尝试但尚未收到交易成功信号)时发生。

