Z Zise Developers
全球账户 › 指南

收款人字段表是动态的 —— 按走廊问一次再渲染表单,别照文档写死。

收款人建档

先问字段表,再渲染表单


GET /v1/remit/payee-form-schema?corridor=…

返回这条走廊要填哪些字段、每个字段的类型与校验规则。照它渲染表单。

不要照着文档里的示例写死一张表单。 不同走廊要的字段差别很大

(有的要 IBAN,有的要 routing number + account type,有的要收款人生日),

而这张表会随上游的要求变化。写死的表现是:某条走廊多要了一个字段之后,

你的用户填完提交,拿到一个他看不懂的校验错误。

建档


POST /v1/remit/payees

我方在这一步只做格式校验。真正的上游建档发生在分发那一步 ——也就是钱已经从会员账上冻走之后。

⚠ 这意味着:本地漏校一条格式,代价是钱已经冻住才发现建不出收款人。

所以字段表要按走廊问,别猜。

校验


POST /v1/remit/payees/{id}/verify

对支持的走廊做一次账户名核对(收款账号与户名对不对得上)。结果有三种:一致、不一致、该走廊不支持核对

第三种不是失败。把它当失败拦住用户的表现是:不支持核对的走廊上一个人都汇不出去。

相关端点