全球账户 › 指南
下单那一刻钱就从会员余额里锁走了 —— 之后的每条路径都要能把它还回去。
下单
POST /v1/remittances { "quote_id": "…", "payee_id": "…" }
下单那一刻发生了什么
1. 校验走廊、收款人、报价没过期2. 从会员的可用余额里锁定一笔钱(含滑点预留)3. 从你的预付账户里冻结我方要收的那部分4. 订单进入处理流程
第 2 步是这条线上最要紧的一件事:钱已经不在会员的可用余额里了。之后的每一条路径 —— 成功、失败、取消、退款 —— 都必须能把它还回去或结算掉。
幂等键:沿用同一把
x-idempotency-key: <你自己的订单号>
网络超时(504)时用同一把键重试 —— 我方可能已经建单了,同键会把那一单返给你。换新键 = 建第二单 = 第二笔真实付款。
⚠ 这与报价的纪律相反。混淆的代价不对称:报价用错键最多显示一个旧价,
出款用错键是钱出去两次。
需要处理的两种停顿
下单之后订单可能停下来等人,两种:
- 需要补件 —— 合规要更多资料
- 需要重新确认 —— 价格变动超出了滑点预留
两者都会发 remittance.order.action_required 事件。处理方式见补件与重新确认。