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

充值到卡与卡内转出

充值到卡

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

下单成功 ≠ 钱到卡。 钱到卡要等card.topup.credited 事件。开卡时带的 first_topup 到账也是这一条，不是另一条事件。

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

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

卡内转出

POST /v1/cards/{id}/withdrawals

把卡内的钱转回会员的钱包余额。钱到钱包要等card.withdraw.completed。共享额度卡的 201 可能已经是 completed，仍会发这一条。

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

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

不要拿本事件的 id 去 GET /v1/withdrawals/{id} —— 那是链上提现。

卡内余额的位置

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

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

相关端点

• POST /v1/cards/{id}/topup-quotes
• POST /v1/cards/{id}/topups
• POST /v1/cards/{id}/withdrawals
• card.withdraw.completed