Skip to main content
如需查看完整的 Schema 衍生目录,请参阅所有示例。

概述

处理 WhatsApp 支付状态更新。

准备工作

  • 在您的应用程序中创建一个公开的 HTTPS 端点。
  • 为您所需的事件类型配置 YCloud Webhook 端点。
  • 安全存储端点签名密钥。
  • 确保事件处理具有幂等性。

工作原理

事件发生时,YCloud 会发送 HTTP POST 请求。验证签名,持久化记录事件,返回 2xx 响应,并异步处理耗时任务。

请求

以下场景展示了发送到您的 Webhook URL 的请求。将事件 id 视为传递标识符,并使用 type 路由有效负载。

响应

接收事件后返回 2xx 状态。
有关端点设置、签名验证和重试机制的更多信息,请参阅配置 Webhook。

支付交易已更新

当用户发起的交易状态发生变更时,您将通过 Webhook 收到更新。这会在支付状态更改为 captured(支付成功完成)或 pending(用户已尝试但尚未收到交易成功信号)时发生。

请求

响应

在持久化接收事件后确认投递。

说明