事件类型
当前订单集成不会发送
order.closed Webhook。请调用 GET /v1/orders/{orderId} 核对 FAILED、CLOSED 或 REVOKED 等未付款终态,参见订单管理。
事件对象结构
所有 Webhook 事件共享相同的顶层结构:order.paid
客户成功完成付款时发送。order.refunded
订单退款已生效时发送。你可以用此事件更新权益、余额或对账记录。 有关控制台退款申请流程和退款状态定义,请查看订单退款。争议事件(开通后可用)
当你的账户支持并开通争议处理时,还可能收到以下通知。是否可用取决于支付渠道和运营配置,请向 Kyren 支持确认。参见争议管理。
两种事件使用相同的顶层结构,
data 包含以下案件快照;可空字段可能暂不可用:
这些通知用于同步案件信息。仅
status 变化不代表余额已变动,请结合资金字段和控制台记录对账。即使 shared_order_projection 为 true,资金金额仍属于单个案件。
处理事件
以下是在 Webhook 端点中处理事件的方式:2xx。