跳转到主要内容
阅读该接口文档前,务必先查看 接口说明

限额

交易类型限额(单位:MXN )
代收(OXXO)10-8000
代收(CASH)10-8000
代收(CLABE)3-50000
代付(CLABE)3-50000

代收API

代收申请

简要描述:
  • 创建代收订单
URL:/mxn/collect/apply 说明:appId需使用墨西哥比索对应的,用户支付成功后增加墨西哥比索余额 参数:
参数名必选类型说明
appIdLong业务ID(后台获取,需要根据URL中的币种传递对应的业务ID)
orderIdString商户订单号(必须保证唯一性,长度不超过48)
nameString收款人姓名(收款人姓名格式:英文大小写且允许有空格,1-30位,“firstName middleName lastName” (middleName非必填,特殊字符支持’.-)
phoneString真实手机号(格式参考 电话号码格式
emailString真实电子邮件
amountString交易金额(单位:Mex$,精确到小数点后两位;禁止添加标点符号,例如:”,“)
payTypeString用户支付方式:QR(条形码支付)或 VA(虚拟账户)
inBankCodeString收款编码,当payType为QR时,inBankCode支持:OXXO、CASH 支付方式;当payType为VA时,inBankCode为CLABE
callBackUrlString用户支付成功后跳转地址
callBackFailUrlString用户支付失败后跳转地址
notifyUrlString回调地址
subjectString支付备注
bodyString备注详情
partnerUserIdString用户唯一标识(如用户ID userId),用于风控系统,必须真实有效,否则会影响交易。 格式要求:数字、大小写字母或常用符号-~!@#$%&*()_。
signString签名
重要说明:
  1. 此接口支持 QR(条形码支付)和 VA(CLABE虚拟账户)两种支付方式
  2. CLABE虚拟账户为单次收款,不支持多次收款
  3. 回调说明请参考 公共接口-异步通知
request — QR支付示例
{
    "amount": "20.00",
    "callBackFailUrl": "https://www.example.com/failed",
    "payType": "QR",
    "callBackUrl": "https://www.example.com/success",
    "inBankCode": "CASH",
    "orderId": "SINGLE_1763358741905",
    "phone": "1234567890",
    "appId": "4755",
    "name": "TEST NAME",
    "partnerUserId": "dfff@fg43123",
    "sign": "Si8+iTS7zZ4oX1bMCZ9PPFoJwgw9mGEwMc1UIADOrbs7xlCL+f5e+OYcvhKa4HXCxybqu6MTft6t6Smy9gvu8bPw/erwHdKbP/QzRDU5qHfMj9+1IZzZvJQJR/i5/TW9Y+L4xkOOsaTXfEYuDsZTjyNqy/si5EbUgl1CzVMuH3BORpB7H2f0P34RHqt8t5SZet7YfZLs+dcriczmqHAKhILHgIc7VHSfiAna00J2KjM93qO6kXa8LIjw7FVbX5f6ZMOUjrl13M3DDx01qSW0JVCSxRqEN9yTYTPMV8eFCSk+Picr78/vyMEKnRjnccUx4OZy1cK/9rIfi538xTEAbQ==",
    "email": "test.single@example.com"
}
request — VA支付示例
{
    "appId": "4755",
    "orderId": "VA_1763358741905",
    "payType": "VA",
    "inBankCode": "CLABE",
    "amount": "43.43",
    "name": "Sofía López Martínez",
    "email": "test@example.com",
    "callBackUrl": "https://www.example.com/success",
    "callBackFailUrl": "https://www.example.com/failed",
    "partnerUserId": "dfff@fg43123",
    "sign": "hYNVZTSCTWeR8X0HfhQ2zxoCTeM5ilX8tElAaNbfGDNzjpklR6r/LQZQ/IEO6SQvAc7EdKnAObcBhOxoUvQbeUNy1o8xcp4TV8ZX32McBPbAB/fu+lPF2SbtahoFs3W5w4Gg3ZMa9nLsStP6m1qER7rfaBOBDmGjUIbwDXUaXYwhLKVepB4N9dmE/r9/kch3SKXkFD/2NlT7HgN4CSWKTr04dd7awgYZm6PFlL9U3F0ZvgCEJouNBezNu2fuVz1ylgPtsXTKn2xLgCekrvwG+9WmQPnQzUC5kVlyLGpKvyVK9EMgHHTfg/12Lu1fyxcqLY8Zm/RAU55lAs/kxLQvpQ=="
}
response — QR支付
{
    "status": "1",
    "error": "00000000",
    "msg": "",
    "data": {
        "orderId": "SINGLE_1763358111905",
        "orderNo": "2025111713522220822",
        "payUrl": "https://www.paycashglobal.com/formato.php?referencia=MTQ3MTMyNDEwMjQzNQ==&interno=1",
        "bankCode": "CASH",
        "qrCode": "1471324102431",
        "sign": "mpcB0wfbvGpCSNbT8Gs+D4Tt1eMDqTgnuY6yVUAdemccC07nnWrxSPk4srHFXeoXpdWm+CKFh89rghU16kZq2pm9dw0jSlns0dj5c7sDO8Te0KMNGfleuQ+N/16sGZr/LE7MAWj6Z902ymiff6q+N1ljTfIDypHTztbGDpJvemZ9OkB2BCemsoAX6ukkXyZJPI+gkyJEDCPfOcWfXeNmdWOKxyXLOJEjIBno2oyZoDs3yJqkMtCyQW1cjgTTOQbnxgCjHV9YQ+OcLVdkFroC/HrP8p9c8qRICDX/NMEt4Z0Zo1eBV07rkebuY60+A1kSuD7axO0UxSq6BbXKjgNqyQ=="
    }
}
response — VA支付
{
    "status": "1",
    "error": "00000000",
    "msg": "",
    "data": {
        "orderId": "VA_1763358741905",
        "orderNo": "2025111713522220823",
        "payUrl": "https://checkout-mx.fusionpay.net?checkout=MjAyNTExMTQxMTAyNTIzNjM0OSZHVjE5ODkxNjY5MzI0MzEwNzczNzYmNjg0MTgwMjkyMDE5ODQ0MDAw",
        "bankCode": "CLABE",
        "bankNo": "684180292019844000",
        "bankUserName": "Sofía López Martínez",
        "sign": "QwXUII9P895b0008Avsep0OqxuxuQai56vAP1ks1saVJnT/hIWiE9rM4i5uI1CQ0yGNGVkVV25evO+7MssalgWqQNr0tTE0RHCJ6nK0baNz680CHp4IFxLp5TV4OLlNpLfyTNxiYLu4TzsFQuOAsDyTzOH6LnBBLC+syn1S8r4OkkcxrjDnonPc6E4wPZyJouiXe7+cxvSWxl+QSn8dXudxBVddhhTbiwJb2+ATZTDDMmeD7BlU9e8x8IKlR9j7l9Xa4hGU/GRvBqNAIhHXiQVldIlOP1I5L9Ez78kty8dyB2+YIgm5q2gRyl+XotAlOjq8cWti4dau1B7gi3bfqtw=="
    }
}
返回data参数说明
参数名类型说明
orderIdString商户订单号(必须保证唯一性)
orderNoString平台订单号
payUrlString支付地址(QR返回条形码支付地址,VA返回CLABE虚拟账户支付地址)
bankCodeString通道Code(QR返回条形码,VA返回CLABE)
qrCodeString条形码,返回的是条形码的编号(仅QR支付返回)
bankNoStringCLABE虚拟账户号码(仅VA支付返回)
bankUserNameString账户名称(仅VA支付返回)
signString签名

代收查询

简要描述:
  • 查询代收订单
  • 异步通知后,通过orderNo查询二次确认状态
URL:/mxn/collect/query 参数:
参数名必选类型说明
appIdLong业务ID(后台获取,需要根据URL中的币种传递对应的业务ID)
orderIdString商户订单号
orderNoString平台订单号(响应快)
signString签名
request
{
    "appId": 1054,
    "orderId": "M22222000028",
    "sign": "EmyJGm3ELzG4FsOc0Krs9ncbSjo4oTGuXWML+7djYla3+VAwa9wS17z38p/7U2ZAjroO04XrE7YXcB1o76Dtyipj3h3bJzs7FYma1QNkMUdt9hh7m8U6hMsMQX7vIWHtXNwz4pbTSC75+kQWXaCew7KoE6LXECdJU8AISgNgeki2TK9R0pCfshr0Z2SZBPeuT6OvIH5LdmqgdZhuqnffGU2qnXk4KMkO848e6/WALLBR+LE1wyKHfPnYVcuKSMVYxkvKyyIL5JIPEgW0o5bh4RCbaUn3NZtyYwrU1uQ3ZDFRThm9j6XAQP+LBlmq3nOePqBtp/VDVarRaV+7FbQg3A=="
}
response
{
    "status": "1",
    "error": "00000000",
    "msg": "",
    "data": {
        "orderId": "M22222000028",
        "orderNo": "6023042811314347",
        "amount": "50000.00",
        "actualAmount": "0.00",
        "fee": "0.00",
        "status": 1,
        "sign": "fP433ygWVDLVGxYkVnGJj7riGq0U3vyVX+MbBAImxfGLZkZcEAHVEoVYuULZSmXAAXKRSyd67WlDNm+24pougM54ofAoH4HMtCL2tfCoBReFyz3z02AGKkrKE2xWhSpWoqfQoBvzwuN5iGMMu0s9Q1YvqiwJ8WDVIENnmiIyD8qDJN7caHTW2US14/faG+69AvnuIgJ/nu7/jogOlgEYdZdVYU7gcRDE+d47KjlFGswQkJ/h/uzV7cWtUqrtOO7ZnZ3/z33Xx8awokX36QoYcPSWAU0h+Ij9O9402HNhm1eTbYcLU0uI/z8xCAtyAI/tTyiFijpiNlxUKQj+zKsILw=="
    }
}
返回data参数说明
参数名类型说明
orderIdString商户订单号(必须保证唯一性)
orderNoString平台订单号
amountString交易金额
actualAmountString收到金额
feeString手续费
statusInteger状态(0未开始,1支付中,2成功(终态),3失败(终态), -1异常待确认)
payTimeString支付成功时间(当status=2,4,5时有值)(墨西哥时间), 格式: yyyy-MM-dd HH:mm:ss
errorMsgString失败原因(当status=3时有值)
signString签名

代付API

代付申请

简要描述:
  • 创建代付订单
URL:/mxn/pay/apply 说明:appId 墨西哥比索, amount 墨西哥比索,实收结算墨西哥比索 参数:
参数名必选类型说明
appIdLong业务ID(后台获取,需要根据URL中的币种传递对应的业务ID)
orderIdString商户订单号(必须保证唯一性,长度不超过48)
amountString交易金额(单位:Mex$,精确到小数点后两位;禁止添加标点符号,例如:”,“)
accountTypeString账户类型:BANK_CARD(借记卡(长度16位) , BANK_ACCOUNT(CLABE(长度18位))
bankCodeString银行代码具体值查看 完整银行编码列表
accountNoString用户银行账号
nameString收款人姓名(收款人姓名 格式:英文大小写且允许有空格,1-30位,“firstName middleName lastName” (middleName 非必填, 特殊字符支持 ’.-))
phoneString真实手机号(格式参考 电话号码格式
emailString真实电子邮件
notifyUrlString回调地址
subjectString支付备注(交易标题,商品名称,支付原因)
bodyString备注详情
partnerUserIdString用户唯一标识(如用户ID userId),用于风控系统,必须真实有效,否则会影响交易。 格式要求:数字、大小写字母或常用符号-~!@#$%&*()_。
signString签名
request
{
    "appId": 1054,
    "orderId": "M100000450012",
    "amount": "55.00",
    "accountType": "BANK_ACCOUNT",
    "bankCode": "STP",
    "accountNo": "99418029201a844099",
    "name": "John Doe",
    "email": "johndoe@example.com",
    "subject": "Payment for services",
    "body": "Payment description",
    "partnerUserId": "73744645@f233",
    "sign": "I1PeK3eJEVsFFNowxVRqMXpeWa1lr/BcRpBi8SsW4wVo1+5AC1JsrFq/m/L3214NzKHvtDWi4zia3DL3dPut0yMyUyqL91LNCSaeISbGsQPlhEsQpyTOryS/RKOfsrn2Xo37SCF/phAvndOk2jwwGwqM5xLz1ms9Ukl85wv27QFNrXIMxK2p181e7MpMYrgf+xvEBE/VqCtKMtN9pO449wWwXzHWNPbZ76s4pAvKwRE9yXQDr7Iw14Dktcnl1FoLM4gWM/obkO+mz6SyAGDuXhVh/+OD/IGNiCyTCNq6ciQY28UnCFV6ZIP40gxsFhfBJKbK+Raw7y1Bh912ifYfug=="
}
response
{
    "status": "1",
    "error": "00000000",
    "msg": "",
    "data": {
        "orderId": "M1000245001F4",
        "orderNo": "3023022014149638",
        "sign": "LmhUnkw5j0pMiimsG6rKwdNNZGvX6GMpSmD1mdHZwq112wuK5BohmdEoqKB/jkMk28o3da4Cxh6Q+tW97+yTCemRrF+dMaHA73rpOeUuujKQl/UcFvJuMhfLBa2tp09L71NzoBqpPD6aXf37mYAz8E1HmERwFPpac5FVxIYanHG8cqmMLJYsVmHTSxWavgWU03ys9UczBePkBiR8sl2FSOhFABB0wAP28lswrV/ABS68IsLKtyd1fyI3GBfSbIK5nDEEnlE+EdElFdLs9taAxJImeVF1x4eT47+bkPJ2qS8z3K8QGzKLF3W+8SiRZGfSwDTsLKH+2Vycvy5auRl+ag=="
    }
}
返回data参数说明
参数名类型说明
orderIdString商户订单号(必须保证唯一性)
orderNoString平台订单号
signString签名

代付查询

简要描述:
  • 查询代付订单状态
URL:/mxn/pay/query 参数:
参数名必选类型说明
appIdLong业务ID(后台获取,需要根据URL中的币种传递对应的业务ID)
orderIdString商户订单号
orderNoString平台订单号(响应快)
signString签名
request
{
    "appId": 1000,
    "orderId": "M1234567111",
    "orderNo": "3022111516571436",
    "sign": "ZxkVZL+GAyv0VhVWn4IvGYahTzxgQuthkuV2ONWiqIfIDb2avvHlFOUJVzqZi1q8CPHXZm1ltanRTRVTxfsuftLvGeDioUHglWt46/RU6c1OPznpLGsZ35Q3n5tW2y1EnOsxPynXBFLuDQy+aZ3l9u6AQ30T0zQexMGT+IxuFkmUp02g/6juaHa5ZgNMv7lN67ixIp162wrM7OJuaOif872QijSceRdZhzaMGImAwB0D4MosRV4WMBOKkwgPdmS7GuZN66YUidXk3wTGqX3MYRw6M0kj4eNegSUwPXvp4q4p0KO8Y3xUMld54GY2ApX3WN3CBtC/vpJqEszjGBbbGg=="
}
response — 订单失败
{
    "status": "1",
    "error": "00000000",
    "msg": "",
    "data": {
        "orderId": "M1234567111",
        "orderNo": "3022111516571436",
        "amount": "100000.00",
        "fee": "0.00",
        "status": 3,
        "errorMsg": "Đơn hàng không tồn tại",
        "sign": "KKuvCl0SuNANJs+l2ogAaJm8pmV+Hi+Xa7q27vJ6D1Ehs4aOp13kRbITfJAhczh3T81BE9qwHeJaYwf+r0EypKM9TL6pMwfG8Az4gRy1D57wiUaVjl2PWcvbEqrn1hL0b+btkjvAM9I+CcSv+wuOW3/uku17Ws3FhgJLj9sFsQUBAPjDO+758VnwBytCOLBmljLBXyKgNgpmFQ1/DNkqWl0UNzyLK45Zw3yf5NiwhEFbvW0jlOWlfu/ql4hluISUQG573jEoFCBEnQLb2tQoRZj1QYNRCXPf5lbej0vzqbEwvR9h+ZOf255t1MocJkdIe463DTV5U3KZdVT87HMagw=="
    }
}
response — 订单成功
{
    "status": "1",
    "error": "00000000",
    "msg": "",
    "data": {
        "orderId": "M1234567112",
        "orderNo": "3022111517401574",
        "amount": "100000.00",
        "fee": "1003.00",
        "status": 2,
        "payTime": "2024-03-01 23:59:59",
        "sign": "khPtOmGq+cpKX0HFAI/lbP0dx4oFyNAnL5oLsdmhDJdASlQm0yg5I3o+MhImYggEsL6c2bo5fP29t54OZFqSdQDfIuNDvGbAMAr4mRBxc0hoHLkBLyyagfVPBLyQA1JY8XV3ZL4ySzQ3ZQnMCfrh2K39ueUuz6HpZ03Hj0KYijVRCXAZaio/L5jfLBT12QXmvIfAHa8s/k9flhK05ENHPep3zjj/MZGOEaX7jkEJLfjK0duypDCa61BRQjM+oePOdVsgleIl1Yf98UAxMDZ/A3912KFHEb+/jvmdnulNbiJFyuT1fEe+j2teUgw3vFsZAtwNWAgxhC7UO+N0Q5z4EA=="
    }
}
返回data参数说明
参数名类型说明
orderIdString商户订单号(必须保证唯一性)
orderNoString平台订单号
amountString交易金额
feeString手续费
statusInteger订单状态(0未开始, 1放款中 2放款成功(终态) 3放款失败(终态) -1异常待确认)
payTimeString支付成功时间(当status=2时有值)(墨西哥时间), 格式: yyyy-MM-dd HH:mm:ss
errorMsgString支付失败原因(当status=3时有值)
signString签名

银行编码

重要说明:
  • 在调用代付接口时,请使用对应的银行名称作为 bankCode 参数值
  • 如果银行名称中包含空格,请用”_“代替,例如 “VE POR MAS”,应为 “VE_POR_MAS”
  • CLABE账户号码为18位数字,前3位为银行代码
  • BANK_CARD(借记卡)账户号码为16位数字
币种支付类型(accountType)支付编码(bankCode)限额状态ABM编码说明
MXNBANK_ACCOUNT/BANK_CARDBANXICO3-50000可用BANXICO
MXNBANK_ACCOUNT/BANK_CARDBANCOMEXT3-50000可用006BANCOMEXT
MXNBANK_ACCOUNT/BANK_CARDBANOBRAS3-50000可用009BANOBRAS
MXNBANK_ACCOUNT/BANK_CARDBANJERCITO3-50000可用019BANJERCITO
MXNBANK_ACCOUNT/BANK_CARDNAFIN3-50000可用135NAFIN
MXNBANK_ACCOUNT/BANK_CARDBANSEFI3-50000可用166BANSEFI
MXNBANK_ACCOUNT/BANK_CARDHIPOTECARIA_FED3-50000可用168HIPOTECARIA FED
MXNBANK_ACCOUNT/BANK_CARDBANAMEX3-50000可用002BANAMEX
MXNBANK_ACCOUNT/BANK_CARDBBVA_MEXICO3-50000可用012BBVA MEXICO
MXNBANK_ACCOUNT/BANK_CARDSANTANDER3-50000可用014SANTANDER
MXNBANK_ACCOUNT/BANK_CARDHSBC3-50000可用021HSBC
MXNBANK_ACCOUNT/BANK_CARDBAJIO3-50000可用030BAJIO
MXNBANK_ACCOUNT/BANK_CARDINBURSA3-50000可用036INBURSA
MXNBANK_ACCOUNT/BANK_CARDMIFEL3-50000可用042MIFEL
MXNBANK_ACCOUNT/BANK_CARDSCOTIABANK3-50000可用044SCOTIABANK
MXNBANK_ACCOUNT/BANK_CARDBANREGIO3-50000可用058BANREGIO
MXNBANK_ACCOUNT/BANK_CARDINVEX3-50000可用059INVEX
MXNBANK_ACCOUNT/BANK_CARDBANSI3-50000可用060BANSI
MXNBANK_ACCOUNT/BANK_CARDAFIRME3-50000可用062AFIRME
MXNBANK_ACCOUNT/BANK_CARDBANORTE3-50000可用072BANORTE
MXNBANK_ACCOUNT/BANK_CARDACCENDO_BANCO3-50000可用102ACCENDO BANCO
MXNBANK_ACCOUNT/BANK_CARDAMERICAN_EXPRES3-50000可用103AMERICAN EXPRES
MXNBANK_ACCOUNT/BANK_CARDBANK_OF_AMERICA3-50000可用106BANK OF AMERICA
MXNBANK_ACCOUNT/BANK_CARDMUFG3-50000可用108MUFG
MXNBANK_ACCOUNT/BANK_CARDJP_MORGAN3-50000可用110JP MORGAN
MXNBANK_ACCOUNT/BANK_CARDBMONEX3-50000可用112BMONEX
MXNBANK_ACCOUNT/BANK_CARDVE_POR_MAS3-50000可用113VE POR MAS
MXNBANK_ACCOUNT/BANK_CARDCREDIT_SUISSE3-50000可用126CREDIT SUISSE
MXNBANK_ACCOUNT/BANK_CARDAZTECA3-50000可用127AZTECA
MXNBANK_ACCOUNT/BANK_CARDAUTOFIN3-50000可用128AUTOFIN
MXNBANK_ACCOUNT/BANK_CARDBARCLAYS3-50000可用129BARCLAYS
MXNBANK_ACCOUNT/BANK_CARDCOMPARTAMOS3-50000可用130COMPARTAMOS
MXNBANK_ACCOUNT/BANK_CARDMULTIVA_BANCO3-50000可用132MULTIVA BANCO
MXNBANK_ACCOUNT/BANK_CARDACTINVER3-50000可用133ACTINVER
MXNBANK_ACCOUNT/BANK_CARDINTERCAM_BANCO3-50000可用136INTERCAM BANCO
MXNBANK_ACCOUNT/BANK_CARDBANCOPPEL3-50000可用137BANCOPPEL
MXNBANK_ACCOUNT/BANK_CARDABC_CAPITAL3-50000可用138ABC CAPITAL
MXNBANK_ACCOUNT/BANK_CARDCONSUBANCO3-50000可用140CONSUBANCO
MXNBANK_ACCOUNT/BANK_CARDVOLKSWAGEN3-50000可用141VOLKSWAGEN
MXNBANK_ACCOUNT/BANK_CARDCIBANCO3-50000可用143CIBANCO
MXNBANK_ACCOUNT/BANK_CARDBBASE3-50000可用145BBASE
MXNBANK_ACCOUNT/BANK_CARDBANKAOOL3-50000可用147BANKAOOL
MXNBANK_ACCOUNT/BANK_CARDPAGATODO3-50000可用148PAGATODO
MXNBANK_ACCOUNT/BANK_CARDINMOBILIARIO3-50000可用150INMOBILIARIO
MXNBANK_ACCOUNT/BANK_CARDDONDE3-50000可用151DONDE
MXNBANK_ACCOUNT/BANK_CARDBANCREA3-50000可用152BANCREA
MXNBANK_ACCOUNT/BANK_CARDBANCO_FINTERRA3-50000可用154BANCO FINTERRA
MXNBANK_ACCOUNT/BANK_CARDICBC3-50000可用155ICBC
MXNBANK_ACCOUNT/BANK_CARDSABADELL3-50000可用156SABADELL
MXNBANK_ACCOUNT/BANK_CARDSHINHAN3-50000可用157SHINHAN
MXNBANK_ACCOUNT/BANK_CARDMIZUHO_BANK3-50000可用158MIZUHO BANK
MXNBANK_ACCOUNT/BANK_CARDBANK_OF_CHINA3-50000可用159BANK OF CHINA
MXNBANK_ACCOUNT/BANK_CARDBANCO_S33-50000可用160BANCO S3
MXNBANK_ACCOUNT/BANK_CARDHEY_BANCO3-50000可用167HEY BANCO
MXNBANK_ACCOUNT/BANK_CARDMONEXCB3-50000可用600

CLABE账户银行代码说明

CLABE(Clave Bancaria Estandarizada)账户号码为18位数字,结构如下:
  • 前3位:银行代码(Bank Code)
  • 第4-6位:分行代码(Branch Office Code)
  • 第7-17位:账户号码(Account Number,11位)
  • 第18位:校验位(Control Digit)
Last modified on April 17, 2026