Z Zise Developers English
卡发行 › Webhook

开卡结果

开卡成功、执行失败、持卡人审核通过,或实体卡可绑定、已绑定时发送。可绑定和已绑定都不代表卡片已可用。

事件类型

事件什么时候发
card.application.approved开卡成功,卡片已可用
card.application.rejected开卡申请执行失败
card.application.submitted已关联持卡人的审核状态同步
card.application.awaiting_bind实体卡已可绑定
card.bound实体卡已绑定,等待激活

投递约定

事件体只带 ID 与状态

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

逐条

card.application.approved 开卡成功,卡片已可用
什么时候发

发卡机构开卡成功、卡片落库之后。data.id 是公开开卡申请单号(已带 cap_),回查走 GET /v1/cards/applications/{data.id};要拿到卡本身用 GET /v1/cards 带 x-on-behalf-of: <external_member_id>。⚠ 2026-08-13 之前这一条发的是会员内部 id(而 data.object 写着card_application)—— 拿它回查必然 404。已修,请按上面的约定读。执行失败或持卡人拒绝导致申请失败时发 card.application.rejected。

事件体
{
  "event_id": "evt_2e6c98a04f1b47d3850ac7e195b3d602",
  "event_type": "card.application.approved",
  "created_at": "2026-08-12T16:03:27Z",
  "merchant_id": "acme",
  "livemode": true,
  "data": {
    "object": "card_application",
    "id": "cap_9c41f0a8-27d5-4e63-b0a9-1f7c85d2e340",
    "external_member_id": "u_88123",
    "status": "approved",
    "status_version": 5
  }
}
card.application.rejected 开卡申请执行失败
什么时候发

申请执行失败,或持卡人明确拒绝导致申请落为 failed 后触发。不依赖会员邮箱;重复执行按申请单号和状态版本去重。通常通知 status 为 rejected,回查申请详情的 status 为 failed。运营结束已失败且保留开卡费的快捷认证申请并退费后,会发送更高状态版本的同类通知;此时 status 仍为 rejected,application_status 为 refunded(无退款则为 canceled)。收到后回查 GET /v1/cards/applications/{data.id} 确认最新申请状态,退款入账以商户资金流水为准;此项退费保留独立收取的快捷 KYC 申请费。通知不包含金额或币种。原始上游原因不外发,处理原因请回查详情里的 failure_code。

事件体
{
  "event_id": "evt_491ad542803841bca106f69ae28a3c14",
  "event_type": "card.application.rejected",
  "created_at": "2026-09-15T08:00:00Z",
  "merchant_id": "acme",
  "livemode": true,
  "data": {
    "object": "card_application",
    "id": "cap_9c41f0a8-27d5-4e63-b0a9-1f7c85d2e340",
    "external_member_id": "u_88123",
    "status": "rejected",
    "status_version": 4
  }
}
card.application.submitted 已关联持卡人的审核状态同步
什么时候发

支持持卡人回查同步的渠道确认已通过时,通知仍在履约中的关联申请。data.status 是申请真实进度,cardholder_review_status 为 approved。这不是开卡成功事件,不应因此重新提交申请或直接展示卡已可用。收到后回查 GET /v1/cards/applications/{data.id}。

事件体
{
  "event_id": "evt_d9f5b7057f6a40d99f05d7631255b888",
  "event_type": "card.application.submitted",
  "created_at": "2026-09-15T08:00:00Z",
  "merchant_id": "acme",
  "livemode": true,
  "data": {
    "object": "card_application",
    "id": "cap_9c41f0a8-27d5-4e63-b0a9-1f7c85d2e340",
    "external_member_id": "u_88123",
    "status": "picking",
    "status_version": 3,
    "cardholder_review_status": "approved"
  }
}
card.application.awaiting_bind 实体卡已可绑定
什么时候发

实体卡到了用户手里、申请单进入 awaiting_bind 之后。下游库存模式的标准申请在审核通过进入履约队列后会自动当面交付到这一档;平台自营则是线下面交确认,或邮寄运单标成用户已签收。data.id 是公开开卡申请单号(已带 cap_),回查走 GET /v1/cards/applications/{data.id},然后POST /v1/cards/bind → POST /v1/cards/{id}/activate。这不是开卡成功:卡还没激活,不要当成已可用。仅 shipped(货还在路上)不发;绑卡之后的 pending_activation 也不发。激活成功仍走 card.application.approved 与 card.status.updated。⚠ 平台自营会员不发。

事件体
{
  "event_id": "evt_b7c1e02a9d3f4e18ac552d61ab0f9e77",
  "event_type": "card.application.awaiting_bind",
  "created_at": "2026-09-21T06:37:35Z",
  "merchant_id": "acme",
  "livemode": true,
  "data": {
    "object": "card_application",
    "id": "cap_9c41f0a8-27d5-4e63-b0a9-1f7c85d2e340",
    "external_member_id": "u_88123",
    "status": "awaiting_bind",
    "status_version": 5
  }
}
card.bound 实体卡已绑定,等待激活
什么时候发

绑卡收尾完成、卡行已经建成之后。POST /v1/cards/bind 返回 binding只表示已受理,那时还不一定有卡行,所以不在那一次响应里发。data.id 是公开卡资源 ID(crd_<id>),回查走 GET /v1/cards/{data.id}。status 是卡的当前状态,绑定刚完成时为 unactivated。有来源申请单时带 application_id(cap_<id>);没有申请单则不带。这不是激活成功。激活仍看 card.application.approved、card.status.updated,自动激活成功另看 card.activated。同一张卡只发一次。不包含卡号、有效期、安全码或 PIN。⚠ 平台自营会员不发。

事件体
{
  "event_id": "evt_c4d8e21b0a6f4d7e9b15c3a28f06d441",
  "event_type": "card.bound",
  "created_at": "2026-10-19T16:48:34Z",
  "merchant_id": "acme",
  "livemode": true,
  "data": {
    "object": "card",
    "id": "crd_e70b3d41-5a28-4c96-91f0-6b2a8c05d7e3",
    "external_member_id": "u_88123",
    "status": "unactivated",
    "status_version": 1,
    "application_id": "cap_9c41f0a8-27d5-4e63-b0a9-1f7c85d2e340"
  }
}

验签

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