创建出款单(墨西哥)
创建墨西哥比索(MXN)出款订单接口,支援 18 位 CLABE 与 16 位银行帐号。
请求资讯
- 请求 URL:
/gateway/api/v2/payouts - 请求方式:
POST - Content-Type:
application/json;charset=utf-8
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| platform_id | 是 | String(6) | 商户 ID |
| service_id | 是 | String(7) | 服务 ID,固定值 SVC0004 |
| payout_cl_id | 是 | String(64) | 商户订单号 |
| amount | 是 | Integer(10) | 金额(分,centavo) |
| notify_url | 否 | String(256) | 交易结果通知地址 |
| bank_name | 是 | String(45) | 银行代码,亦可传银行英文名称(不分大小写),银行列表 |
| name | 是 | String(64) | 受款人户名 |
| number | 是 | String(64) | 受款人帐号:18 位 CLABE 或 16 位银行帐号,仅限数字 |
| currency | 是 | String(3) | 固定值:mxn |
| request_time | 是 | Integer(10) | 请求时间(秒) |
| sign_type | 否 | String(16) | 签名类型,固定值 HMAC-SHA256 |
| sign | 是 | String(32|64) | 订单签名 |
服务 ID
SVC0004银行卡代付
返回示例
{
"error_code": "0000",
"data": { "payout_id": "POT00000001" }
}
备注
重要提示
如遇超时或 HTTP 500 错误,请以订单查询接口状态为依据,不可直接视为订单失败。
- 交易金额单位为墨西哥比索(分,centavo),请乘以 100 传入
bank_name请传 墨西哥银行列表 中的银行代码或银行英文名称number帐号格式:- 18 位 CLABE:18 位纯数字,且须通过 CLABE 检查码校验
- 16 位银行帐号:16 位纯数字
- 不可含空格、连字号或其他字符,其他长度一律拒单
- 收款资讯校验不通过时于建单阶段即返回错误,不会产生订单:
bank_name未传、name为空、number为空或格式不符(含 CLABE 检查码错误)返回0002(无效请求参数);bank_name不在银行列表内返回0012(不支援的银行) - 返回 "0000" 仅代表接口调用成功,请调用查询接口确认结果