Skip to main content
启润支付会为以下事件类型发送 Webhook 通知。

事件类型

当前订单集成不会发送 order.closed Webhook。请调用 GET /v1/orders/{orderId} 核对 FAILED、CLOSED 或 REVOKED 等未付款终态,参见订单管理。

事件对象结构

所有 Webhook 事件共享相同的顶层结构:

order.paid

客户成功完成付款时发送。
这是最重要的事件。用它来完成订单处理 — 例如,为用户的账户充值额度。

order.refunded

订单退款已生效时发送。你可以用此事件更新权益、余额或对账记录。 有关控制台退款申请流程和退款状态定义,请查看订单退款。

争议事件(开通后可用)

当你的账户支持并开通争议处理时,还可能收到以下通知。是否可用取决于支付渠道和运营配置,请向 Kyren 支持确认。参见争议管理。 两种事件使用相同的顶层结构,data 包含以下案件快照;可空字段可能暂不可用: 这些通知用于同步案件信息。仅 status 变化不代表余额已变动,请结合资金字段和控制台记录对账。即使 shared_order_projection 为 true,资金金额仍属于单个案件。

处理事件

以下是在 Webhook 端点中处理事件的方式:
处理函数必须在持久化完成后才确认事件。较长的处理请采用持久化队列方案,只有保存成功后才能返回 2xx。