跳至主要內容

墨西哥

TOPPAY Team大约 5 分钟

国家域名及编码（墨西哥）

国家/地区国家编码域名货币代码货币名称
墨西哥mxglobal-mx-openapi.toppayment.comMXN墨西哥比索

域名：推荐使用统一域名 openapi.toppayment.com（路径不变）；原国别域名仍可继续使用。

实际域名与商户环境以运营配置为准；路径模板与其他国家一致：/sandbox/{countryCode}/...（沙箱）、/{countryCode}/...（生产）。

代收支付方式编码（method）

调用墨西哥代收接口时，在 method 传递下列编码（接口说明见 代收订单-墨西哥）：

  • 收银台模式：/pay/prePay（method 可选）
  • API 模式：/pay/transOrder（method 必填）
支付方式编码说明
SPEI银行转账（SPEI）
CODI扫码支付（CoDi）
OXXO线下 OXXO

若网关扩展更多 method，以接口返回与运营下发清单为准。开放接口字段及示例见 代收订单-墨西哥。

金额格式（代收 / 代付）

正数金额，整数或最多两位小数；不允许全为 0；不允许三位及以上小数。各接口请求体中的 amount 说明见 代收订单-墨西哥、代付订单-墨西哥。

代收通知规则（SPEI / 同一 CLABE 多笔到账）

针对 SPEI 等场景：同一收款指令（同一 orderNum，对应同一 CLABE 或同一收银链路）下，付款人可以分多笔转入；每笔实际成功入账都可能触发一次代收成功类回调通知，不要求当次实付金额与下单金额一致。

  • orderNum（商户订单号）：多次回调中保持不变。
  • platOrderNum（平台订单号）：每笔到账事件对应一条，每次成功回调都会生成新的平台单号（即多个平台订单号）。
  • 实付金额字段（示意字段名如 payMoney，以网关实际返回为准）：表示该次回调对应的单笔实收金额，各次通知可以不同。

商户处理建议：以 platOrderNum 作为入账与幂等校验的主键，对每笔通知单独记账、对账；不要仅凭 orderNum + 成功状态只处理一次，以免漏记分笔到账。

示意（字段名以实际回调为准）：

第一次到账通知示例：

{
  "code": "00",
  "description": "desc",
  "method": "SPEI",
  "msg": "SUCCESS",
  "orderNum": "TEST00000000000001",
  "payFee": "3",
  "payMoney": "25",
  "platOrderNum": "PRE10262034203986608803927",
  "platSign": "…",
  "status": "SUCCESS"
}

第二次到账通知示例（同一 orderNum，不同 platOrderNum 与 payMoney）：

{
  "code": "00",
  "description": "desc",
  "method": "SPEI",
  "msg": "SUCCESS",
  "orderNum": "TEST00000000000001",
  "payFee": "3",
  "payMoney": "15",
  "platOrderNum": "SUB1034205556524208141",
  "platSign": "…",
  "status": "SUCCESS"
}

代付通知规则（银行报送与央行审核链路）

代付付款经合作银行提交至墨西哥央行等环节审核。链路上可能出现多段状态与多次异步通知：

  1. 银行先行回调：受理侧可能先回调成功（表示已受理并进入后续审核/清算），不等于资金已对收款人最终到账成功。
  2. 央行与收款行审核：央行将信息返回至客户账户所属银行等继续校验；资料与账号全部正确时，才会最终成功。
  3. 失败与退款、二次通知：若信息不符或账号等问题，银行侧可能做退款处理，并可能再下发第二次（或更多次）回调，携带失败原因。
  4. 终态认定：存在多笔通知时，以最后一次通知为准作为业务终态；请勿将第一次成功回调直接视为代付完成。

详细请求体与通用状态说明见 代付订单-墨西哥、交易状态码。

SPEI 参与机构（代付 bankCode / 展示 bankName）

墨西哥代付走 SPEI 时，bankCode 为下表 数字机构码（与渠道侧 SPEI 清单一致），bankName 为展示名。若同一机构码在渠道存在多条名称映射，以网关与运营返回为准。

bankCodebankName渠道
40012BBVA MEXICOSPEI
40137BANCOPPELSPEI
40127AZTECASPEI
90638NU MEXICO/AKALASPEI
40072BANORTESPEI
40014SANTANDERSPEI
40002BANAMEXSPEI
90728SPIN BY OXXOSPEI
90722Mercado Pago WSPEI
40021HSBCSPEI
90646STPSPEI
40058BANREGIOSPEI
40138UALASPEI
37019BANJERCITOSPEI
40062AFIRMESPEI
90720MexPagoSPEI
37006BANCOMEXTSPEI
37009BANOBRASSPEI
37135NAFINSPEI
37166BaBien/BANSEFISPEI
37168HIPOTECARIA FEDSPEI
40030BAJIOSPEI
40036INBURSASPEI
40042MIFELSPEI
40044SCOTIABANKSPEI
40059INVEXSPEI
40060BANSISPEI
40106BANK OF AMERICASPEI
40108MUFGSPEI
40110JP MORGANSPEI
40112BMONEXSPEI
40113VE POR MASSPEI
40126CREDIT SUISSESPEI
40128AUTOFINSPEI
40129BARCLAYSSPEI
40130COMPARTAMOSSPEI
40132MULTIVA BANCOSPEI
40133ACTINVERSPEI
40136INTERCAM BANCOSPEI
40140CONSUBANCOSPEI
40141VOLKSWAGENSPEI
40143CIBANCOSPEI
40145BBASESPEI
40147BANKAOOLSPEI
40148PAGATODOSPEI
40150INMOBILIARIOSPEI
40151DONDESPEI
40152BANCREASPEI
40154BANCO COVALTO/BANCO FINTERRASPEI
40155ICBCSPEI
40156SABADELLSPEI
40157SHINHANSPEI
40158MIZUHO BANKSPEI
40159BANK OF CHINASPEI
40160BANCO S3SPEI
90600MONEXCBSPEI
90601GBMSPEI
90602MASARISPEI
90605VALUESPEI
90608VECTORSPEI
90613MULTIVA CBOLSASPEI
90616FINAMEXSPEI
90617VALMEXSPEI
90620PROFUTUROSPEI
90630CB INTERCAMSPEI
90631CI BOLSASPEI
90634FINCOMUNSPEI
90642REFORMASPEI
90652CREDICAPITALSPEI
90653KUSPITSPEI
90656UNAGRASPEI
90659ASP INTEGRA OPCSPEI
90661KLARSPEI
90670LIBERTADSPEI
90677CAJA POP MEXICASPEI
90680CRISTOBAL COLONSPEI
90683CAJA TELEFONISTSPEI
90684TRANSFERSPEI
90685FONDO (FIRA)SPEI
90686INVERCAPSPEI
90688CREDICLUBSPEI
90689FOMPEDSPEI
90703TESOREDSPEI
90706ARCUS FISPEI
90710NVIOSPEI
90723CuencaSPEI
90901CLSSPEI
90902INDEVALSPEI
90903CoDi ValidaSPEI
40124CITI MEXICOSPEI
90699FONDEADORASPEI
90732PeiboSPEI
90715CASHI CUENTASPEI
40167HEY BANCOSPEI
90734FINCO PAYSPEI
90721ALBOSPEI
2001BANXICOSPEI
90729Dep y Pag DigSPEI
90725COOPDESARROLLOSPEI
90738FINTOCSPEI
90727TRANSFER DIRECTSPEI
90730SwapSPEI

代收与代付订单 status 字段取值说明见 交易状态码。

代付请求体字段及示例见 代付订单-墨西哥。

Copyright © 2026 TOPPAY Team