统一状态表
出款：带资金冻结的生命周期
- 全部扣款金额（
total_debit）在操作进行期间离开available并停留在held中。 failed始终将全部扣款金额（金额 + 手续费）自动退回available。- 处于
processing的出款无法通过 API 取消：请等待最终状态 （webhook 或GET /v1/payouts/{id}）。
失败出款的 status_code 目录
当出款失败时，status_code 与 status_message 以中立的措辞说明
失败原因：
无论哪种情况，退款都已经完成：可在
GET /v1/movements 中核实
（一条 payout_refund 记录）。
收款：收款状态
pending— 收款单已创建并等待付款。QR 和支付页面会过期 （无人付款则变为expired）。credited— 已收到付款，按您的payin_rate换算并入账。unassigned— 收到一笔无法匹配到任何账户的入金；由管理员手动 分配，随后按目标账户的汇率与费用入账。failed— 收款失败（例如付款人拒绝了 collect 扣款）。 没有资金变动。
加密货币提现：链上确认
提现在交易于网络上确认后到达completed。典型耗时：TRON 约
1 分钟（19 个确认），以太坊数分钟，视拥堵程度而定。tx_id
会在响应和 webhook 中返回，供您在区块浏览器上核实。
若提现在广播之前失败，全部扣款金额将被退回
（一条 withdrawal_refund 记录）。
卡片
pending_activation— 实体卡已发行并以未激活状态寄出；通过POST /v1/cards/{id}/activate激活。active— 实时授权消费，扣减卡片消费资产的余额 （spending_asset：USDT、USDC、BTC 或 GOLD）。frozen— 已冻结（手动冻结或因月费未付）；消费会被拒绝并返回unfunded_card_frozen。结清待付费用后即可解冻。cancelled— 最终状态；不可撤销。
通用规则
什么时候可以信任一个状态？
什么时候可以信任一个状态？
通过 webhook 或通过该资源的
GET 获得最终状态 — 两者是等效的
事实来源。webhook 是推送方式（推荐）；GET 是 webhook 丢失时的
兜底方案。创建操作时遇到超时该怎么办？
创建操作时遇到超时该怎么办？
不要用新的键重试。使用相同的
idempotency_key 重复同一请求
（它会返回原始对象并附带 idempotency_hit: true），或查询资源列表。
详见幂等性。状态会回退吗？
状态会回退吗？
不会。生命周期是单调的：
completed 和 failed 是最终结论，
操作绝不会回到之前的状态。在哪里能看到每个状态对我余额的影响？
在哪里能看到每个状态对我余额的影响？
在
GET /v1/movements 中：每次产生经济影响的状态转换都会留下一条
不可变的账目记录（payout_debit、payout_refund、payin_credit……）。
参见账目变动与对账。