全球账户 › 指南
走廊、报价、锁定额、滑点预留 —— 四个词决定了这条线的全部形状。
核心概念
走廊
「从哪个币种汇到哪个国家的哪种收款方式」。走廊决定三件事:
1. 收款人要填哪些字段(动态字段表)2. 汇率与费用怎么算 3. 多久到账
用 GET /v1/remit/corridors拿当前可用的走廊。别缓存超过一天 —— 走廊会因为上游维护临时下线。
报价
报价是一个带时限的承诺:这一刻用这个汇率、收这些费用。
有效期 75 秒
过期之后必须重新报价,不能拿旧报价下单。这不是我方保守 ——汇率在这 75 秒里可能已经动了,而承担差价的是我方。
锁定额与滑点预留
下单那一刻我方从会员余额里锁定一笔钱。这笔钱比报价里的「会员实付」略多一点,多出来的是滑点预留:
锁定额 = 会员实付 + 滑点预留
为什么需要它:从下单到上游真正出款之间有时间差,跨币种时汇率会动。预留不够就得让会员重新确认(那是一次糟糕的体验),预留太多则占用他的钱。
结算时多锁的部分原路退回。
状态版本
订单出参带 status_version。合并状态时只许向前更新:
if (incoming.status_version > local.status_version) apply(incoming)
少了这一条,一个慢响应会把「已到账」打回「处理中」——而用户已经看到过「已到账」了。