Mexico

The necessary information for Mexico is presented below in order to carry out a correct payout.

Mandatory parameters

Field	Description
country	String (Required- Lenght: 3 digits) ISO 3166-1-alpha-3. In the case of Mexico: MEX
amount	Integer (Required- Lenght: 10 digits) The amount of the transaction. The 2 last digits will be consider as decimal. Ex: 100000 equals "one thousand"
currency	String (Required- Lenght: 3 digits) The currency of the payroll. ISO-4217. In the case of MEX: MXN You can see the explication on Currencies
orderId	String (Required- Lenght: 20 digits) Merchant transaction code (Purchase Order)
description	String (Required- Lenght: 50 digits) For customer use
beneficiary.name	String (Required) Name of the Beneficiary
beneficiary.lastName	String (Required) Last name of the Beneficiary
beneficiary.email	String (Required) Beneficiary's email
beneficiary.document.type	Integer (Required) Type of Account of the beneficiary to pay. You must enter the numeric code as indicated
beneficiary.document.number	String (Required) Contains the beneficiary's document number.
destination.bankAccount.bankCode	String (Required) Code of the receiving bank or financial institution.
destination.bankAccount.clabe	Integer (Required) Clave of the beneficiary to pay. It must have 18 digits
subMerchantInfo.code	String (Required only for PSP) Submerchant Identifier
subMerchantInfo.name	String (Required only for PSP) Submerchant Name
subMerchantInfo.url	String (Required only for PSP) Submerchant URL

Request Example

Success Test

{
	"country": "MEX",
	"amount": 100000,
	"currency": "MXN",
	"orderId": "R123456",
	"description": "FreeTextFreeTextFreeTextFreeText",
	"beneficiary": {
		"name": "Sergio",
		"lastName": "test",
		"email": "[e-mail]",
		"document": {
			"type": 1,
			"number": "1234567891123"
		}
	},
	"destination": {
		"bankAccount": {
			"bankCode": "001",
			"clabe":"646180110400000007",
		}
	}
}

Rejected Test

{
	"country": "MEX",
	"amount": 100000,
	"currency": "MXN",
	"orderId": "R123456",
	"description": "FreeTextFreeTextFreeTextFreeText",
	"beneficiary": {
		"name": "Sergio",
		"lastName": "test",
		"email": "[e-mail]",
		"document": {
			"type": 1,
			"number": "1234567891123"
		}
	},
	"destination": {
		"bankAccount": {
			"bankCode": "001",
			"clabe":"646180110400000003",
		}
	}
}

Time Outs

In the case of receiving a Time Out as a response from this API we recommend resending the payout again after 30 seconds using the same orderId.

This way we will check if the payout was processed and avoid double payments.

Document Validations

Parameter	ID Type	Lenght
1	INE	13
2	CURP	18
3	RFC	10 or 13 digits
4	PAS	18 max length

Account Type

Parameter	Type
1	Current account
2	Savings account

Not a required field for Mexico

Bank List

Code	Name
001	BANXICO
006	Banco Nacional de Comercio Exterior
009	BANOBRAS
019	Banco Nacional del Ejercito y Fuerza Aerea y Armada
135	Nacional Financiera
166	Bansefi
168	Hipotecaria Federal
002	Banamex
012	BBVA
014	Santander Mexicano
021	HSBC
030	Banco del Bajio
032	Ixe Banco
036	Banco Inbursa
042	Banca Mifel
044	Scotiabank
058	Banco Regional de Monterrey
059	Banco Invex
060	Bansi
062	Banco Afirme
072	Banorte
106	Bank of America Mexico
108	MUFG
110	JP Morgan
112	BMONEX
113	VE POR MAS
126	Credit Suisse
127	Azteca
128	AUTOFIN
129	BARCLAYS
130	COMPARTAMOS
132	MULTIVA BANCO
133	ACTINVER
136	INTERCAM BANCO
137	BANCOPPEL
138	ABC CAPITAL
140	CONSUBANCO
141	VOLKSWAGEN
143	CIBANCO
145	BBASE
147	BANKAOOL
148	PAGATODO
150	INMOBILIARIO
151	DONDE
152	BANCREA
154	BANCO COVALTO
155	ICBC
156	SABADELL
157	SHINHAN
158	MIZUHO BANK
159	BANK OF CHINA
160	BANCO S3
600	MONEXCB
601	GBM
602	MASARI
605	VALUE
608	VECTOR
613	MULTIVA CBOLSA
616	FINAMEX
617	VALMEX
620	PROFUTURO
630	CB INTERCAM
631	CI BOLSA
634	FINCOMUN
638	NU MEXICO
646	STP
648	TACTIV CB
652	CREDICAPITAL
653	KUSPIT
656	UNAGRA
659	ASP INTEGRA OPC
661	ALTERNATIVOS
670	LIBERTAD
677	CAJA POP MEXICA
680	CRISTOBAL COLON
683	CAJA TELEFONIST
684	OPM
685	FONDO (FIRA)
686	INVERCAP
688	CREDICLUB
689	FOMPED
703	TESORED
706	ARCUS
710	NVIO
901	CLS
902	INDEVAL
903	CoDi Valida