汇款需要处理

一笔汇款停下来等人：补件、或价格变动需要重新确认。

事件类型

事件	什么时候发
`remittance.order.action_required`	球在会员脚下：要确认新价格，或要补充材料

投递约定

我方向你配置的端点发 POST，application/json，超时 10 秒。
回任意 2xx 即视为收到。 非 2xx 或超时会按退避重投。
请求头四个：content-type · z-signature · z-event-id · z-event-type。
按 z-event-id 去重 —— 同一条事件可能到达多次。

事件体只带 ID 与状态

没有金额、没有资产代码、没有卡号的任何片段、没有风控原因。这不是省字节 —— webhook 端点是你的服务，我方没有办法保证它的传输与存储；而 GET /v1/<资源>/{id} 那条路径上有 API Key、scope、代理会员三层校验。要详情就拿 data.id 回查， 别指望从事件体里读出金额来记账。

逐条

remittance.order.action_required 球在会员脚下：要确认新价格，或要补充材料

什么时候发

两件事共用这一条：汇率变动超过会员设的上限需要重新确认，或上游要求补充材料。两件都有时限：重新确认逾期这一单自动取消并退回冻结资金；材料不交这一单就停在那里，钱一直冻着。收到它请立刻把会员引到这一单上，并回查GET /v1/remittances/rmt_<id>/pending-action 看究竟要他做什么 ——事件体里区分不了这两件事。

事件体

{
  "event_id": "evt_74b0d3e18f6a4c29ba51e07d962f4c83",
  "event_type": "remittance.order.action_required",
  "created_at": "2026-08-12T14:12:19Z",
  "merchant_id": "acme",
  "livemode": true,
  "data": {
    "object": "remittance",
    "id": "1c0e8a37-45bd-4f6a-b2e1-90a7d3f5c862",
    "external_member_id": "u_88123",
    "status": "action_required",
    "status_version": 3
  }
}

验签

验签方式与所有事件一致，见 Webhook 概览；可以用签名调试器逐字符比对签名串。