Global Account
全球账户
跨境汇款:走廊与币种、收款人建档、报价、下单、补件与重新确认,以及商户自己的换汇备料。
指南
全球账户概述跨境汇款:先建收款人,再报价,再下单。三步之间各有一个会卡住的地方。核心概念走廊、报价、锁定额、滑点预留 —— 四个词决定了这条线的全部形状。支持的走廊与币种支持哪些走廊是动态的,且会临时下线。别在你这边硬编码一张表。收款人建档收款人字段表是**动态的** —— 按走廊问一次再渲染表单,别照文档写死。个人线:开通与使用个人汇款(POBO)以会员本人的名义汇出 —— 要先给他开一个上游子账户。试算试算是纯计算 —— 不建单、不冻结、没有 quote_id。成交价在分发那一刻才定。下单下单那一刻钱就从会员余额里锁走了 —— 之后的每条路径都要能把它还回去。订单生命周期15 档状态、哪些是终局、每一档钱在哪 —— 认不出的一律告警,绝不 fallback。补件与重新确认停下来等人的两种:补件与重新确认。**都不会自动超时退款**。商户换汇商户换汇是给**你自己的预付**备料,与会员的站内兑换不是一回事。集成 FAQ接这条线时最常问的六个问题。
Webhook
API 参考 · 25 个端点
走廊与汇率 Corridors & Rates
GET
/v1/remit/corridors
可用走廊(按商户授权过滤)
GET
/v1/remit/rates
牌价(不建单、不要收款人)
GET
/v1/remit/conversion-dates
可交割日(「几号到」的预告)
GET
/v1/remit/swift-search
银行目录搜索(BIC / 行名 → 行名 + 地址)
收款人 Payees
GET
/v1/remit/payee-form-schema
该走廊要填哪些字段(先验走廊再给表单)
GET
/v1/remit/payees
收款人列表(含 name_mismatch 风控位)
POST
/v1/remit/payees
新建或关联收款人(建档不碰上游)
GET
/v1/remit/payees/{id}
单条收款人(含 upstream_status)
PATCH
/v1/remit/payees/{id}
改收款人的备注名 / 收藏(只能改这两项)
DELETE
/v1/remit/payees/{id}
解除关联(删的是关联不是主体)
POST
/v1/remit/payees/{id}/verify
提前把收款人送去上游建档(不动一分钱)
报价 Quotes
GET
/v1/remit/products
汇款两条线的下单前置(用途码 / 滑点 / 最低起汇额 / 限额)
POST
/v1/remit/quotes
汇款试算(不建单不冻结;必读 applied_rate)
汇款单 Remittances
GET
/v1/remittances/{id}
汇款订单详情
GET
/v1/remit/vp/agreement
个人汇款开户协议正文(六语言 · 提交前必须让用户读到)
GET
/v1/remit/vp/applications
查个人线开户进度
POST
/v1/remit/vp/applications
提交个人线(POBO)开户申请
GET
/v1/remittances
汇款订单列表
POST
/v1/remittances
下单(付款重试沿用同一把幂等键)
动钱
POST
/v1/remittances/{id}/cancel
取消(只有 needs_reconfirm 可撤)
动钱
POST
/v1/remittances/{id}/reconfirm
接受涨价并补冻(4 小时时效)
动钱
GET
/v1/remittances/{id}/pending-action
这单在等用户做什么(重新确认 / 补件 / 无)