充值到卡是两段异步 —— 下单成功不等于钱到卡了。

充值到卡与卡内转出

充值到卡

POST /v1/cards/{id}/topup-quotes   ← 报价（会员付多少那种资产）
POST /v1/cards/{id}/topups         ← 下单

下单成功 ≠ 钱到卡。 钱到卡要等card.topup.credited 事件。

⚠ 在到账事件之前不要给会员放开限额，也不要在界面上说「已到账」。

提前放开的表现是限额已开而钱没到 —— 会员刷卡被拒，而你的界面说余额够。

卡内转出

POST /v1/cards/{id}/withdrawals

把卡内的钱转回会员的钱包余额。

⚠ 这与链上提现是两门生意，

只是中文都叫「提现」。这一个的钱从卡回到钱包，不出我方账本。

卡内余额的位置

卡内的钱物理上在上游，我方在账本上给它一个独立的桶。这带来两条：

• 销卡前必须清空 —— 见冻结与销卡
• 拒付罚金不扣它 —— 罚金只扣可用余额；扣不动就记欠款

相关端点

• POST /v1/cards/{id}/topup-quotes
• POST /v1/cards/{id}/topups
• POST /v1/cards/{id}/withdrawals