Z Zise Developers
全球账户 › 指南

走廊、报价、锁定额、滑点预留 —— 四个词决定了这条线的全部形状。

核心概念

走廊

「从哪个币种汇到哪个国家的哪种收款方式」。走廊决定三件事:

1. 收款人要填哪些字段(动态字段表)2. 汇率与费用怎么算 3. 多久到账

GET /v1/remit/corridors拿当前可用的走廊。别缓存超过一天 —— 走廊会因为上游维护临时下线。

报价

报价是一个带时限的承诺:这一刻用这个汇率、收这些费用。


有效期 75 秒

过期之后必须重新报价,不能拿旧报价下单。这不是我方保守 ——汇率在这 75 秒里可能已经动了,而承担差价的是我方。

锁定额与滑点预留

下单那一刻我方从会员余额里锁定一笔钱。这笔钱比报价里的「会员实付」略多一点,多出来的是滑点预留


锁定额 = 会员实付 + 滑点预留

为什么需要它:从下单到上游真正出款之间有时间差,跨币种时汇率会动。预留不够就得让会员重新确认(那是一次糟糕的体验),预留太多则占用他的钱。

结算时多锁的部分原路退回

状态版本

订单出参带 status_version合并状态时只许向前更新


if (incoming.status_version > local.status_version) apply(incoming)

少了这一条,一个慢响应会把「已到账」打回「处理中」——而用户已经看到过「已到账」了。