Z Zise Developers
全球账户 › 指南

下单那一刻钱就从会员余额里锁走了 —— 之后的每条路径都要能把它还回去。

下单


POST /v1/remittances   { "quote_id": "…", "payee_id": "…" }

下单那一刻发生了什么

1. 校验走廊、收款人、报价没过期2. 从会员的可用余额里锁定一笔钱(含滑点预留)3. 从你的预付账户里冻结我方要收的那部分4. 订单进入处理流程

第 2 步是这条线上最要紧的一件事:钱已经不在会员的可用余额里了。之后的每一条路径 —— 成功、失败、取消、退款 —— 都必须能把它还回去或结算掉。

幂等键:沿用同一把


x-idempotency-key: <你自己的订单号>

网络超时(504)时用同一把键重试 —— 我方可能已经建单了,同键会把那一单返给你。换新键 = 建第二单 = 第二笔真实付款

⚠ 这与报价的纪律相反。混淆的代价不对称:报价用错键最多显示一个旧价,

出款用错键是钱出去两次。

需要处理的两种停顿

下单之后订单可能停下来等人,两种:

两者都会发 remittance.order.action_required 事件。处理方式见补件与重新确认

相关端点