状态参考
状态流转
冻结卡片
冻结会临时禁用所有交易。在卡片被解除冻结之前,所有到达的授权请求都会被拒绝。card.status.update.succeeded webhook:
解除冻结
要重新激活一张已冻结的卡片,把状态改回ACTIVE:
注销卡片
把卡片状态改为CANCELLED:
PRE_CANCEL 状态:
- 所有新的授权请求都会被拒绝。
- 此前已授权但尚未结算的交易会正常完成结算。
- 经过 30 天等待期后,卡片进入
CANCELLED状态。
注销时的余额处理
Webhook 顺序
card.status.update.succeeded,card_status: PRE_CANCEL—— 注销请求发出后立即触发card.status.update.succeeded,card_status: CANCELLED—— 等待期结束后触发
Webhook
以下状态变更会触发card.status.update.succeeded webhook:ACTIVE、FROZEN、BLOCKED、PRE_CANCEL、CANCELLED。
该 webhook 不会在实体卡首次激活或虚拟卡签发默认进入 ACTIVE 状态时触发 —— 这两种场景分别由 Card Created 和 Activation Status webhook 覆盖。
相关链接
- Update Card Status API
- Card Status Updated webhook
- 核心概念 —— Single 与 Share 模式注销时的差异

