跳到主要内容

创建出款单(墨西哥)

创建墨西哥比索(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" 仅代表接口调用成功,请调用查询接口确认结果