第 1 步:获取支付方式模板
在添加收款人之前,请获取所选支付方式的模板。模板会准确告诉您该支付方式需要填写哪些字段。 端点请求参数
常用支付方式 ID
模板响应示例
- 墨西哥 — SPEI (Finco Pay)
- 阿根廷 — CVU/CBU (Momentum)
- SEPA (Bridge)
- WIRE / ACH (Lead Bank)
Account Type:clabe(虚拟账户)或 debit(银行卡账户)。
Bank Code:仅当 Account Type 为 debit 时必填。第 2 步:添加收款人
获取目标支付方式的模板后,填写字段并提交POST 请求,在某个商户下注册该收款人。
端点
请求参数
请求示例
墨西哥 MXN — SPEI (Finco Pay)
墨西哥 MXN — SPEI (Finco Pay)
阿根廷 ARS — CVU/CBU (Momentum)
阿根廷 ARS — CVU/CBU (Momentum)
巴西 BRL — Pix (Genial)
巴西 BRL — Pix (Genial)
Pix Type 可接受的值:CPF(11 位数字)、CNPJ(14 位数字)、EMAIL、PHONE(10-11 位数字)、RANDOM_KEY(含 -)。哥伦比亚 COP — Automatic ACH
哥伦比亚 COP — Automatic ACH
全球 USD — Wire (CPN)
全球 USD — Wire (CPN)
响应字段
- 成功
- 账户重复
管理收款人
创建收款人后,您可以通过其他 API 操作对其进行管理:获取收款人
通过用户支付 ID 获取已保存收款人的详情。
删除收款人
删除不再需要的收款人。
设置退款账户
将某个收款人指定为商户的默认退款目的地。
获取支付模板
所有支付方式模板及字段要求的完整参考。
在同一商户 ID 和
paymentId 下,同一收款账号同一时间只能有一条处于 valid 状态的记录。如果您尝试添加重复记录,API 将返回 status: 3,并附带指向现有有效记录的 sameAccountNumberId。