卡发行 › 指南
冻结与解冻是两个过渡态；销卡不可逆且必须先清空卡内资金。
冻结、挂失与销卡
冻结与解冻是两个过渡态
active ──冻结──► freezing ──► frozen ──解冻──► unfreezing ──► active
不是一个「过渡中」状态来回用。 合并成一个正是「解冻之后报卡状态无效 +充值失败」那个线上故障的成因。
⚠ 过渡态期间不要往卡里推钱。那是往一张状态未定的卡里充值。
挂失与补换
POST /v1/cards/{id}/lost ← 挂失
POST /v1/cards/{id}/replacements ← 补换
余额不会在新旧卡之间直接转 —— 上游没有卡间转账接口。正确顺序是：旧卡转出 → 新卡充值。
销卡
GET /v1/cards/{id}/close-check ← 先查能不能销
POST /v1/cards/{id}/close
销卡不可逆，且必须先清空卡内资金。 跳过清空的话，上游「自动退回」的钱回的是我方账户，而会员的卡内余额还挂着正数 —— 那笔账要人工去补。
close-check 会告诉你还差什么。别跳过它直接销 ——它是这条线上唯一一个能提前发现问题的地方。