Payout Account Type

Value	含义	Order remarks
3	Bank account number	16 digits, will validate
40	Clabe	18 digits, will validate

TIP

When the beneficiary bank is STP (bankId=24), the payment account type is only allowed to be a clabe account (i.e. accountType=40)

Payout Bank List

TIP

The bank support list is subject to the actual support status of the production environment. It is recommended that you call our bank list query interface to confirm the production bank support status before entering the production environment.

bankId	bankCode	bankName
5	91812	BBVA BANCOMER2
6	91802	BANAMEX2
7	90903	CoDi Valida
8	90902	INDEVAL
10	90706	ARCUS
11	90689	FOMPED
12	90686	INVERCAP
13	90685	FONDO (FIRA)
15	90683	CAJA TELEFONIST
16	90680	CRISTOBAL COLON
17	90677	CAJA POP MEXICA
18	90670	LIBERTAD
19	90659	ASP INTEGRA OPC
20	90656	UNAGRA
21	90653	KUSPIT
22	90652	CREDICAPITAL
24	90646	STP
25	90638	AKALA
26	90634	FINCOMUN
27	90631	CI BOLSA
28	90630	CB INTERCAM
29	90620	PROFUTURO
30	90617	VALMEX
31	90616	FINAMEX
32	90613	MULTIVA CBOLSA
33	90608	VECTOR
34	90605	VALUE
35	90602	MASARI
36	90601	GBM
37	90600	MONEXCB
38	40160	BANCO S3
39	40158	MIZUHO BANK
40	40157	SHINHAN
41	40156	SABADELL
42	40155	ICBC
43	40154	BANCO COVALTO
44	40152	BANCREA
45	40151	DONDE
46	40150	INMOBILIARIO
47	40148	PAGATODO
48	40147	BANKAOOL
49	40145	BBASE
50	40143	CIBANCO
51	40141	VOLKSWAGEN
52	40140	CONSUBANCO
53	40138	ABC CAPITAL
54	40137	BANCOPPEL
55	40136	INTERCAM BANCO
56	40133	ACTINVER
57	40132	MULTIVA BANCO
58	40130	COMPARTAMOS
59	40129	BARCLAYS
60	40128	AUTOFIN
61	40127	AZTECA
62	40126	CREDIT SUISSE
63	40113	VE POR MAS
64	40112	BMONEX
65	40110	JP MORGAN
66	40108	MUFG
67	40106	BANK OF AMERICA
68	40072	BANORTE
69	40062	AFIRME
70	40060	BANSI
71	40059	INVEX
72	40058	BANREGIO
73	40044	SCOTIABANK
74	40042	MIFEL
75	40036	INBURSA
76	40030	BAJIO
77	40021	HSBC
78	40014	SANTANDER
79	40012	BBVA MEXICO
80	40002	BANAMEX
81	37168	HIPOTECARIA FED
83	37135	NAFIN
84	37019	BANJERCITO
85	37009	BANOBRAS
86	37006	BANCOMEXT
87	2001	BANXICO
88	40159	BANK OF CHINA
89	90642	REFORMA
92	90703	TESORED
93	90710	NVIO
94	37166	BANSEFI
95	90661	ALTERNATIVOS

TIP

The TACTIV CB institution with bankId 23/90/91, formerly CB EVERCORE, suspends the Reception and Sending of Payment Instructions in the SPEI System as of October 2, 2023.

Payout Order Status Enum

Parameter	Description	Remark
PROCESSING	PROCESSING
WAITING	Wait for payment
PAYING	Payment Paying
SUCCESS	Payment successful	Order final status
FAIL	Payment failed	Order final status
CANCEL	Order Canceled	Order final status

TIP

Note that when processing callbacks or query results from Cashy, the order status should be accurately judged. Only the final result can be considered as a clear success of the collection order.

Payout Order Status Description

Value	Description
ACCOUNT_NOT_EXIST	Account does not exist
ACCOUNT_FREEZING	Account Freeze
ACCOUNT_BLOCKED	Account frozen
TRACKING_KEY_REPEATED	Issuer tracking key exception
CODI_WITHOUT_NOTICE	CODI does not notify payment
ISSUED_CERT_EXPIRED	The issued certificate has expired
COMPLIANCE_REJECT	Payment declined due to compliance
INVALID_BANK_INSTITUTION	Invalid operating organization
CLABE_INSTITUTION_NOT_MATCH	CLABE does not match institution
REJECT_BY_PLD	Rejected by PLD
ACCOUNT_CANCEL	Account canceled
ACCOUNT_IN_ANOTHER_CURRENCY	Account in another currency
ACCOUNT_NOT_BELONG_TO	Account does not belong to receiving participant
MCH_NOT_KNOW_PAYMENT	The payee does not acknowledge the payment
MISS_MUST_PAYMENT_INFO	Missing required information to complete payment
ERROR_PAYMENT_TYPE	Wrong payment method
ERROR_OPERATION_TYPE	Error operation type
ACCOUNT_TYPE_NOT_APPLICABLE	Account type not applicable
INVALID_CHARACTER	Invalid character
OUT_ACCOUNT_BALANCE	Exceeded authorized account balance limit
OUT_ACCOUNT_MONTH_BALANCE	Exceeded the credit limit allowed for the account for the month
NOT_REGISTER_TELPHONE	Unregistered mobile number
NOT_RECEIVE_BANXICO_PAYMENT	Additional accounts will not receive payments not from Banxico
INFO_STRUCTURE_INVALID	The additional information structure is incorrect
UNKNOWN_ERROR	Unknown error
GATEWAY_TIMEOUT	Payment gateway timeout
AMOUNT_ERROR	Wrong amount
PARAM_IS_NULL	Required parameters are empty
NONSUPPORT_PAY_CASH	Does not support cash payment
NONSUPPORT_CREDIT_CARD	Credit cards are not supported
APPID_ERROR	Wrong application ID
PARAM_ERROR	Parameter error
SYSTEM_EXCEPTION	Upstream system exception
UP_STREAM_SYSTEM_EXCEPTION	Upstream system exception
PAYMENT_TRANSACTION_EXCEPTION	Payment transaction exception
PAYMENT_QUERY_FAIL	Payment query failed
BANK_NAME_ERROR	Wrong bank name
BANK_CODE_ERROR	Bank coding error
BANK_ACCOUNT_ERROR	Wrong bank account number
PAYMENT_OFFSET	Payment offset
INVALID_ACCOUNT_NUMBER	Invalid account number
ACCOUNTS_NOT_AUTHORISED_FOR_CREDITING	Unauthorized crediting to account
NUMBER_AND_DOCUMENTS_NOT_MATCH	Account number and ID do not match
DOCUMENTS_INVALID	The document number is invalid
ACCOUNT_NOT_ENABLED	Account is not enabled
BLOCKED_ACCOUNTS	Blocked accounts
ACCOUNT_TYPE_NOT_VALID_FOR_TARGET_BANK	The account type is invalid for the target bank
EACH_PAYMENT_LIMIT_EXCEEDED	The payment amount exceeds the maximum limit for a single payment
DAILY_PAYMENT_LIMIT_EXCEEDED	The payment amount exceeds the maximum daily cumulative payment limit
MONTHLY_PAYMENT_LIMIT_EXCEEDED	The payment amount exceeds the maximum monthly cumulative payment limit
YEARLY_PAYMENT_LIMIT_EXCEEDED	The payment amount exceeds the maximum annual cumulative payment limit
AMOUNT_TOO_SMALL	The payment limit was too low and was rejected by the bank
ACCOUNTING_BILL_ERROR	Error paying bill
PHONE_NUMBER_INVALID	Invalid mobile number
PAYMENT_REJECTED_BY_BANK	Payment transaction declined by bank
PAYMENT_CANCEL_BY_BANK	The payment transaction was canceled by the bank
PAYMENT_REJECTED_BY_BENEFICIARY_BANK	The payment transaction was rejected by the beneficiary bank
PAYMENT_REJECTED_BY_BENEFICIARY_USER	The payment transaction was declined by the payee

Payin PayType Enum

payType	类型	描述
41	OXXO	OXXO Store Cash Payment (Supported Stores: OXXO)
69	SPEI	SPEI (Clabe) - Online Bank Transfer
70	PAYLINK	Aggregate Cashier - Not Supported
71	PAYNET	PayNet Store Cash Payment (Supported Stores: 7-11， Walmart (retailer))

Payin Order Status Enum

Parameter	Description	Remark
PAYING	Wait for payment
SUCCESS	Payment successful	Order final status
FAIL	Payment failed	Order final status

TIP

Note that when processing callbacks or query results from Cashy, the order status should be accurately judged. Only the final result can be considered as a clear success of the collection order.

Common Error Messages

Value	Description	Countries covered
System_error	System error	All
System_busy	System busy (Can retry)	All
System_Maintenance	System Maintenance (Can retry)	All
MerchantId_is_null	MerchantId is empty	All
Sign_verify_error	Merchant signature verification error	All
RequestMethod_not_post	Not a POST request	All
RequestContentType_not_json	Not an application/json request	All
RequestBody_is_null	The request body is empty	All
MerchantId_not_Number	MerchantId is not a number	All
MerchantId_is_error	Merchant Id error	All
Request_ip_notWhiteList	Request ip non-whitelist	All
Params_jsonFormat_error	Request body json format error	All
Params_xxx_Required	Parameter xxx is required	All
Params_xxx_error	Parameter xxx error	All
Params_accountNo_Format_isIncorrect	The bank account number format is incorrect (the length of the bank card number does not match the bank)	Some countries
Merchant_amount_notEnough	Merchant balance is insufficient	All
Merchant_not_enabled	Merchant is not enabled	All
Merchant_not_exist	Merchant does not exist	All
Params_order_notExist	The platform order number does not exist	All
Params_mchOrderNo_notExist	The merchant order number does not exist	All
Params_mchOrderNo_repeat	Duplicate merchant order number	All
Channel_Maintenance_time	The channel is under maintenance, please contact technical support for testing environment	All
Tran_risk_intercept	Transaction risk control interception, check whether the amount meets the restriction conditions	All
Params_accountName_Maximum<40>characters	Payout (beneficiary) payee name is too long	Some countries，MX is 40 characters
Params_idType_Exists_idCard_CPF_Invalidate	CPF Number Invalidate	BR
COLLECTION_ACCOUNT_DAY_LIMIT	The number of times the payment card number reaches the daily limit limit	All
COLLECTION_NAME_DAY_LIMIT	The number of times the payee name reaches the daily limit limit	All
LIMIT_MIN_AMOUNT	The order amount is less than the minimum amount limit	All
LIMIT_MAX_AMOUNT	The order amount is higher than the maximum amount limit	All
BLACK_LIST_USER_LIMIT	The user is on the blacklist	All
Params_realName_not_contain_Chinese	Account names are not allowed to contain Chinese	All
Params_accountName_not_contain_Chinese	Account names are not allowed to contain Chinese	All
Params_accountNo_Clabe_Invalidate	Clabe is invalid	Mexico
Params_email_format_invalid	The email format is invalid	Mexico
Params_email_length_exceeds<64>characters	The mailbox length exceeds 64 characters (the mailbox length should be kept below 64 characters)	All