跳转到主要内容
每张卡都遵循从创建到注销的生命周期。你可以通过 Update Card Status 接口管理状态变更。

状态参考

状态流转

冻结卡片

冻结会临时禁用所有交易。在卡片被解除冻结之前,所有到达的授权请求都会被拒绝。
响应:
冻结生效后,会触发一次 card.status.update.succeeded webhook:

解除冻结

要重新激活一张已冻结的卡片,把状态改回 ACTIVE

注销卡片

注销不可逆,已注销的卡片无法重新激活。
把卡片状态改为 CANCELLED
卡片首先会进入 PRE_CANCEL 状态:
  • 所有新的授权请求都会被拒绝。
  • 此前已授权但尚未结算的交易会正常完成结算。
  • 经过 30 天等待期后,卡片进入 CANCELLED 状态。

注销时的余额处理

如要避免 30 天等待期,可以在注销卡片前,通过 Card Withdraw 接口先把剩余余额提取出来。

Webhook 顺序

  1. card.status.update.succeededcard_status: PRE_CANCEL —— 注销请求发出后立即触发
  2. card.status.update.succeededcard_status: CANCELLED —— 等待期结束后触发

Webhook

以下状态变更会触发 card.status.update.succeeded webhook:ACTIVEFROZENBLOCKEDPRE_CANCELCANCELLED 该 webhook 不会在实体卡首次激活或虚拟卡签发默认进入 ACTIVE 状态时触发 —— 这两种场景分别由 Card CreatedActivation Status webhook 覆盖。