Z Zise Developers English
卡发行 › Webhook

卡内转出到账

卡内资金退回会员钱包、账本已结清那一刻发送。

事件类型

事件什么时候发
card.withdraw.completed卡内资金已退回会员钱包

投递约定

事件体只带 ID 与状态

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

逐条

card.withdraw.completed 卡内资金已退回会员钱包
什么时候发

POST /v1/cards/{id}/withdrawals 的钱已经从卡退回钱包、账本结清那一刻。共享额度卡可能在 201 时已经是 completed,仍会发这一条 —— 201 不等于你可以当作没事件;以本事件(或再查卡余额)为准。销卡触发的自动退回也发这一条。⚠ 这与 withdrawal.order.completed(会员自助链上提现)不是同一门生意。data.id 是卡内转出单的裸 uuid;开放 API 响应里的 id 是 cwd_<uuid>。没有单笔回查端点,拿卡 id 去 GET /v1/cards/crd_<id> 看余额。

事件体
{
  "event_id": "evt_9c2e1b4a7d854f0a8b3c6e1d4f7a90b2",
  "event_type": "card.withdraw.completed",
  "created_at": "2026-09-09T03:56:58Z",
  "merchant_id": "acme",
  "livemode": true,
  "data": {
    "object": "card_withdrawal",
    "id": "c0d94014-40c5-4222-8d6b-795bb5c6f1f2",
    "external_member_id": "u_88123",
    "status": "completed",
    "status_version": 2
  }
}

验签

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