全球账户 › 指南
收款人字段表是动态的 —— 按走廊问一次再渲染表单,别照文档写死。
收款人建档
先问字段表,再渲染表单
GET /v1/remit/payee-form-schema?corridor=…
返回这条走廊要填哪些字段、每个字段的类型与校验规则。照它渲染表单。
⚠ 不要照着文档里的示例写死一张表单。 不同走廊要的字段差别很大
(有的要 IBAN,有的要 routing number + account type,有的要收款人生日),
而这张表会随上游的要求变化。写死的表现是:某条走廊多要了一个字段之后,
你的用户填完提交,拿到一个他看不懂的校验错误。
建档
POST /v1/remit/payees
我方在这一步只做格式校验。真正的上游建档发生在分发那一步 ——也就是钱已经从会员账上冻走之后。
⚠ 这意味着:本地漏校一条格式,代价是钱已经冻住才发现建不出收款人。
所以字段表要按走廊问,别猜。
校验
POST /v1/remit/payees/{id}/verify
对支持的走廊做一次账户名核对(收款账号与户名对不对得上)。结果有三种:一致、不一致、该走廊不支持核对。
第三种不是失败。把它当失败拦住用户的表现是:不支持核对的走廊上一个人都汇不出去。