Monnet error codes
In this segment, you will find information about the typical error codes and remedies that you might come across while utilizing the Monnet API.
The Monnet API utilizes ordinary HTTP response codes to demonstrate whether an API request has been successful or unsuccessful.
Response codes that fall within the 2xx range typically imply that the request was successful. Meanwhile, codes within the 4xx range indicate an error caused by incorrect or inadequate information provided, such as a missing parameter. Lastly, response codes within the 5xx range signify an internal error.
code string Attribute for the status of the error code.
message array de strings Error message returned.Rejections Layer 1 (Basic Validation)
Rejections Layer 1 (Basic Validation)
1001
Missing or invalid Authentication
Authentication
All
1010
Missing field [country]
country
All
1011
Missing field [amount]
amount
All
1012
Missing field [currency]
currency
All
1013
Missing field [orderId]
orderId
All
1014
Missing field [beneficiary]
beneficiary
All
1015
Missing field [beneficiary.name]
beneficiary(name)
All
1016
Missing field [beneficiary.lastName]
beneficiary(lastName)
All
1017
Missing field [beneficiary.document]
document
All
1019
Missing field [beneficiary.document.type]
document(type)
All
1020
Missing field [destination]
document(destination)
All
1021
Missing field [destination.bankAccount]
document(bankAccount)
All
1022
Missing field [beneficiary.document.number]
document(number)
All
1023
Missing field [destination.bankAccount.bankCode]
destination(bankCode)
All
1024
Missing field [destination.bankAccount.accountType]
destination(accountType)
All
1025
Missing field [destination.bankAccount.accountNumber]
destination(accountNumber)
All (-ARG, -MEX, -PER)
1026
Missing field [destination.bankAccount.cci]
destination(cci)
Peru
1027
Missing field [destination.bankAccount.alias]
destination(alias)
Argentina
1028
Missing field [destination.bankAccount.cbu]
destination(cbu)
Argentina
1030
Missing field [destination.bankAccount.clabe]
clabe
Mexico
1031
[Field] exceeds allowed characters
Any
All
1032
Missing field
?
1033
Missing field [beneficiary.email]
beneficiary(email)
Colombia
1034
Wrong format [beneficiary.email]
beneficiary(email)
Argentina
1035
The following attribute is not valid: [field]. Validate attribute exist and comply with case sensitive.
Any
All
Rejections Layer 1 (Field Validation)
1101
[country] not allowed for merchantId
country
All
1102
[country] invalid
country
All
1103
[amount] only accepts numeric values
amount
All
1104
[currency] invalid
currency
All
1105
[beneficiary.document.type] invalid
document(type)
All
1106
[beneficiary.document.number] only accepts numeric values
document (number)
All (-MEX)
1107
[destination.bankAccount.bankCode] invalid
destination(bankCode)
All
1108
[destination.bankAccount.accounType] invalid
destination(accountType)
All
1109
[destination.bankAccount.accountNumber] only accepts numeric values
destination(accountNumber)
All
1110
[amount] invalid length
amount
1111
[destination.bankAccount.accountNumber] must be a string
[destination.bankAccount.accountNumber
1112
[destination.bankAccount.cci] must be a string
destination.bankAccount.cci
1113
[destination.bankAccount.cbu] must be a string
destination.bankAccount.cbu
1114
[destination.bankAccount.clabe] must be a string
destination.bankAccount.clabe
1115
[destination.bankAccount.bankCode] must be a string
destination.bankAccount.bankCode
1116
[destination.bankAccount.accountType] must be a number
destination.bankAccount.bankCode
1117
[amount] must be a number
amount
1118
[beneficiary.document.type] must be a number
document(type)
[currency] not allowed for merchantId
currency
All
Rejections Layer 1 ARGENTINA
1351
[beneficiary.document.number] must have between 11-13 characters for [beneficiary.document.type] = CUIL
document
400
Argentina
1352
[beneficiary.document.number] must have between 11-13 characters for [beneficiary.document.type] = CUIL
document
400
Argentina
1353
[destination.bankAccount.accountNumber] must have 22 digits
document
400
Argentina
1354
[beneficiary.document.number] must have 7 or 8 digits digits for [beneficiary.document.type] = DNI
document
400
Argentina
1356
[destination.bankAccount.cbu] is mandatory for [beneficiary.document.type] = DNI
destination(cbu)
400
Argentina
1357
[destination.bankAccount.cbu] invalid
destination(cbu)
400
Argentina
1358
[destination.bankAccount.alias] must have between 6-20 digits
destination(alias)
400
Argentina
1359
[destination.bankAccount.alias] must be alphanumeric and it it allows only the special characters '.', '-'
destination(alias)
400
Argentina
Rejections Layer 1 CHILE
1301
[beneficiary.document.number] must have between 7-12 characters for [beneficiary.document.type] = RUT
document(number)
400
Chile
1302
[beneficiary.document.number] must have between 7-12 characters for [beneficiary.document.type] = RUN
document(number)
400
Chile
1303
[beneficiary.document.number] must have 9 or more digits for [beneficiary.document.type] = PAS
document(number)
400
Chile
1304
[beneficiary.document.number] must have 9 or more digits for [beneficiary.document.type] = CE
document(number)
400
Chile
1305
[destination.bankAccount.accountNumber] must be have the first 6 digits of [beneficiary.document.number] for [destination.bankAccount.bankCode] = 012 (Banco del Estado de Chile) and [destination.bankAccount.accounType] = 4
destination(accountNumber)
400
Chile
1306
[destination.bankAccount.accountNumber] must have between 6-20 digits
destination(accountNumber)
400
Chile
Rejections Layer 1 COLOMBIA
1501
[destination.bankAccount.accountNumber] must have between 6-20 digits
destination(accountNumber)
400
Colombia
1502
[beneficiary.document.number] must have 6 or more digits
destination(accountNumber)
400
Colombia
1503
[amount] the last two digits must be 00
amount
400
Colombia
1505
[destination.bankAccount.accountType] must be Savings Account for [destination.bankAccount.bankCode] = 507 (NEQUI)
destination(accountType)
400
Colombia
1506
[destination.bankAccount.accountNumber] must have 10 digits for [destination.bankAccount.bankCode] = 507 (NEQUI)
destination(accountNumber)
400
Colombia
1507
[destination.bankAccount.accountNumber] must start with the number 3 for [destination.bankAccount.bankCode] = 507 (NEQUI)
destination(accountNumber)
400
Colombia
1508
[destination.bankAccount.accountNumber] must have 12 or more digits for [destination.bankAccount.bankCode] = 051 (BANCO DAVIVIENDA S.A.) NEW!
destination(accountNumber)
400
Colombia
1509
[destination.bankAccount.accountNumber] must be up to 11 digits for [destination.bankAccount.bankCode] = 007 (BANCOLOMBIA)
destination(accountNumber)
400
Colombia
1510
[destination.bankAccount.accountNumber] must be up to 11 digits for [destination.bankAccount.bankCode] = 032 (BANCO CAJA SOCIAL BCSC S.A.)
destination(accountNumber)
400
Colombia
1511
[destination.bankAccount.accountNumber] must be up to 9 digits for [destination.bankAccount.bankCode] = 001 (BANCO DE BOGOTÁ)
destination(accountNumber)
400
Colombia
1512
[destination.bankAccount.accountNumber] must have 10 digits for [destination.bankAccount.bankCode] = 551 (DEVIPLATA)
destination(accountNumber)
400
Colombia
1513
[destination.bankAccount.accountNumber] must start with the number 3 for [destination.bankAccount.bankCode] = 551 (DEVIPLATA)
destination(accountNumber)
400
Colombia
1514
[destination.bankAccount.accountType] must be Savings Account for [destination.bankAccount.bankCode] = 551 (DEVIPLATA)
destination(accountType)
400
Colombia
1515
[amount] must not exceed 1000000 for [destination.bankAccount.bankCode] = 099 (Efecty)
amount
400
Colombia
1516
[destination.bankAccount.accountType] must be Cash for [destination.bankAccount.bankCode] = 099 (EFECTY)
destination.bankAccount.accountType
400
Colombia
1517
[destination.bankAccount.bankCode] must be 099 (EFECTY) for [destination.bankAccount.accountType] = Cash
destination.bankAccount.bankCode
400
Colombia
1518
[amount] must be 20000 COP or more for bank 099 (EFECTY)
amount
400
Colombia
1519
[destination.bankAccount.expirationDate] must have this structure: YYYY-MM-DD
destination(expirationDate)
400
Colombia
1520
[destination.bankAccount.expirationDate] must be at least one calendar day up to 7 days.
destination(expirationDate)
400
Colombia
1521
[beneficiary.document.type] must be CC, TI or CE for [destination.bankAccount.bankCode] = 507 (NEQUI)
destination(tpe)
400
Colombia
Rejections Layer 1 ECUADOR
1251
[beneficiary.document.number] must have 10 digits for [beneficiary.document.type] = Cedula
document(number)
400
Ecuador
1252
[beneficiary.document.number] must have 13 digits for [beneficiary.document.type] = PAS
document(number)
400
Ecuador
1253
[beneficiary.document.number] must have 13 digits for [beneficiary.document.type] = RUC
document(number)
400
Ecuador
1254
[destination.bankAccount.accountNumber] must have 10 digits for [destination.bankAccount.bankCode] = 010 (Banco Pichincha C.A.)
destination(accountNumber)
400
Ecuador
1255
[destination.bankAccount.accountNumber] must have 10 digits for [destination.bankAccount.bankCode] = 017 (Banco de Guayaquil S.A)
destination(accountNumber)
400
Ecuador
1256
[destination.bankAccount.accountNumber] must have between 7-20 digits
destination(accountNumber)
400
Ecuador
1257
[beneficiary.document.number] the last three digits must be 001 for [beneficiary.document.type] = PAS
document(number)
400
Ecuador
1258
[beneficiary.document.type] must be Cedula or PAS for [beneficiary.document.accountType] = EFE
document(number)
400
Ecuador
1259
[destination.bankAccount.bankCode] must be = 010 (Banco Pichincha C.A.) for [beneficiary.document.accountType] = EFE
destination(bankCode)
400
Ecuador
1260
[amount] must not exceed 2000 USD for [destination.bankAccount.accountType] = EFE
amount
400
Ecuador
1261
[beneficiary.email] is required for accountType = CASH
beneficiary(email)
400
Ecuador
1262 NEW!
[destination.bankAccount.accountNumber] must have between 5-20 digits for [destination.bankAccount.bankCode]= 032 (Banco Internacional)
[destination.bankAccount.accountNumber]
400
Ecuador
Rejections Layer 1 GUATEMALA
1551
[beneficiary.document.number] must have 13 digits for documentType = DNI
document(number)
400
Guatemala
1552
[beneficiary.document.number] must have 10 or 13 digits for documentType = NIT
document(number)
400
Guatemala
Rejections Layer 1 HONDURAS
1401
[beneficiary.document.number] must have 13 characters for [beneficiary.document.type] = DNI
document(number)
400
Honduras
1402
[beneficiary.document.number] must have 9 or more digits for [beneficiary.document.type] = PAS
document(number)
400
Honduras
1403
[beneficiary.document.number] must have 9 or more digits for [beneficiary.document.type] = CE
document(number)
400
Honduras
Rejections Layer 1 MEXICO
1451
[destination.bankAccount.clabe] must be have 18 digits
destination(clabe)
400
Mexico
1452
[destination.bankAccount.clabe] only accepts number values
destination(clabe)
400
Mexico
1453
[beneficiary.document.number] must have 10 or 13 digits for [beneficiary.document.type] = RFC
document (number)
400
Mexico
1454
First 3 digits of the [destination.bankAccount.clabe] must match the [destination.bankAccount.bankCode]
destination(clabe)
400
Mexico
1455
[beneficiary.document.number] only accepts alphanumeric values for [beneficiary.document.type] = RFC
document (number)
400
Mexico
1456
[beneficiary.document.number] must have 13 digits for [beneficiary.document.type] = INE
document(number)
400
Mexico
1457
[beneficiary.document.number] must have 18 digits for [beneficiary.document.type] = CURP
document(number)
400
Mexico
1458
[beneficiary.document.number] is up to 18 digits for [beneficiary.document.type] = PAS
document(number)
400
Mexico
1459
[beneficiary.document.number] only accepts numeric values for [beneficiary.document.type] = INE
document (number)
400
Mexico
1460
[beneficiary.document.number] only accepts numeric values for [beneficiary.document.type] = CURP
document (number)
400
Mexico
1461
[beneficiary.document.number] only accepts numeric values for [beneficiary.document.type] = PAS
document (number)
400
Mexico
Rejections Layer 1 PERU
1201
[beneficiary.document.number] must have 8 digits for [beneficiary.document.type] = DNI
document(number)
400
Peru
1202
[beneficiary.document.number] must have between 7-12 digits for [beneficiary.document.type] = PAS
document(number)
400
Peru
1203
[beneficiary.document.number] must have between 8-12 digits for [beneficiary.document.type] = CE
document(number)
400
Peru
1204
[beneficiary.document.number] must have 11 digits for [beneficiary.document.type] = RUC
document(number)
400
Peru
1205
[destination.bankAccount.accountNumber] must have between 18-20 digits for [destination.bankAccount.bankCode] = 001 (Banco Continental)
destination(accountNumber)
400
Peru
1206
[destination.bankAccount.accountNumber] must have 13 digits for [destination.bankAccount.accountType] = Current account and [destination.bankAccount.bankCode] = 002 (Banco de Credito)
destination(accountNumber)
400
Peru
1207
[destination.bankAccount.accountNumber] must have 13 digits for [destination.bankAccount.bankCode] = 003 (Interbank)
destination(accountNumber)
400
Peru
1208
[destination.bankAccount.accountNumber] must have 10 digits for [destination.bankAccount.bankCode] = 004 (Scotiabank)
destination(accountNumber)
400
Peru
1209
[destination.bankAccount.cci] must have 20 digits
destination(CCI)
400
Peru
1210
[destination.bankAccount.cci] only accepts numeric values
destination(CCI)
400
Peru
1213
[destination.bankAccount.accountNumber] must contain '0' digit in position 11 for [destination.bankAccount.accountType] = Current account, [destination.bankAccount.bankCode] = 002 (Banco de Credito) and [currency] = PEN
[destination.bankAccount.accountNumber]
400
Peru
1214
[destination.bankAccount.accountNumber] must contain '1' digit in position 11 for [destination.bankAccount.accountType] = Current account,[destination.bankAccount.bankCode] = 002 (Banco de Credito) and [currency] = USD
[destination.bankAccount.accountNumber]
400
Peru
1215
[destination.bankAccount.cci] field must begin with '011' for [destination.bankAccount.bankCode] = 001 (Banco Continental) and [destination.bankAccount.accountType] = Current account
[destination.bankAccount.cci]
400
Peru
1216
[destination.bankAccount.cci] field must begin with '002' for [destination.bankAccount.bankCode] = 002 (Banco Continental)
[destination.bankAccount.cci]
400
Peru
1217
[destination.bankAccount.cci] must contain '00' digits in position 7 and 8 for [destination.bankAccount.bankCode] = 002 (Banco de Credito) and [destination.bankAccount.accountType] = Current account
[destination.bankAccount.cci]
400
Peru
1218
[destination.bankAccount.cci] must contain '1' digit in position 7 for [destination.bankAccount.bankCode] = 002 (Banco de Credito) and [destination.bankAccount.accountType] = Savings account
[destination.bankAccount.cci]
400
Peru
1219
[destination.bankAccount.cci] must begin with '003' for [destination.bankAccount.bankCode] = 003 (Interbank)
[destination.bankAccount.cci]
400
Peru
1220
[destination.bankAccount.cci] must begin with '009' for [destination.bankAccount.bankCode] = 004 (Scotiabank)
[destination.bankAccount.cci]
400
Peru
1221
[destination.bankAccount.accountNumber] must contain '0' digit in position 12 for [destination.bankAccount.accountType] = Savings account, [destination.bankAccount.bankCode] = 002 (Banco de Credito) and [currency] = PEN
[destination.bankAccount.accountNumber]
400
Peru
1222
[destination.bankAccount.accountNumber] must contain '1' digit in position 12 for [destination.bankAccount.accountType] = Savings account, [destination.bankAccount.bankCode] = 002 (Banco de Credito) and [currency] = USD
[destination.bankAccount.accountNumber]
400
Peru
1223
[destination.bankAccount.accountNumber] must have 14 digits for [destination.bankAccount.accountType] = Savings account and [destination.bankAccount.bankCode] = 002 (Banco de Credito)
destination(accountNumber)
400
Peru
1224
[amount] exceeds the limit allowed for this destination bank
amount
400
Peru
1225
[destination.bankAccount.cci] first three digits not registered in the banks of Peru
[detail.cciNumber] first three digits not registered in the banks of Peru
400
Peru
1226 NEW!
[destination.bankAccount.accountNumber] must be numeric with 9 digits and start with the number “9” when [destination.bankAccount.accountType]= Cellphone Number
[destination.bankAccount.accountNumber]
400
Peru
1227 NEW!
[amount] must not exceed 500 PEN for [destination.bankAccount.accountType]= Cellphone number
[amount]
400
Peru
1228 NEW!
[currency] must be PEN for [destination.bankAccount.accountType]= Cellphone number
[currency]
400
Peru
1229 NEW!
[destination.bankAccount.bankCode] is mandatory when [destination.bankAccount.accountType]= Cellphone Number
[destination.bankAccount.bankCode]
400
Peru
1230 NEW!
[destination.bankAccount.cci] must contain '0' digit in position 16 for [destination.bankAccount.accountType] = Current account,[destination.bankAccount.bankCode] = 002 (Banco de Credito) and [currency] = PEN
[destination.bankAccount.cci]
400
Peru
1231 NEW!
[destination.bankAccount.cci] must contain '1' digit in position 16 for [destination.bankAccount.accountType] = Current account,[destination.bankAccount.bankCode] = 002 (Banco de Credito) and [currency] = USD
[destination.bankAccount.cci]
400
Peru
1232 NEW!
[destination.bankAccount.cci] must contain '0' digit in position 16 for [destination.bankAccount.accountType] = Savings account, [destination.bankAccount.bankCode] = 002 (Banco de Credito) and [currency] = PEN
[destination.bankAccount.cci]
400
Peru
1233 NEW!
[destination.bankAccount.cci] must contain '1' digit in position 16 for [destination.bankAccount.accountType] = Savings account, [destination.bankAccount.bankCode] = 002 (Banco de Credito) and [currency] = USD
[destination.bankAccount.cci]
400
Peru
Rejections Layer 2 (Bussiness Validation)
2003
[currency] not allowed for merchantId
currency
All
2005
[orderId] Duplicated
orderId
All
2006
[beneficiary.document.number] does not correspond to the bank account of the beneficiary
beneficiary.document.number
All
2007
[destination.bankAccount.alias] is inactive
destination(alias)
Argentina
2008
CCI duplicated. This CCI account has already been used previously with another document.number
destination.bankAccount.cci
Peru
2009
[destination.bankAccount.alias] could not be validated
destination(alias)
Argentina
2010
[amount] must not exceed 10000000.00 COP
amount
Colombia (Nequi, DAVIPLATA) NEW!
2011
[amount] must be equal o greater than 1000 COP
amount
Colombia NEW!
2012
[amount] must not be less than 1 USD
amount
Ecuador NEW!
Rejections Layer 3 (Fraud Validation)
3000
Fraud Validation - Bank account in Black List
destionation(accountNumber)
3001
Fraud Validation - CCI account in Black List
destination(cci)
3002
Fraud Validation - Document Number in Black List
beneficiary(document.number)
3003
Fraud Validation - Email in Black List
beneficiary(email)
3004
Fraud Validation - Account number allows to another Customer ID
beneficiary(customerId)
3005
Fraud Validation - Amount must not exceed 25,000
amount
3006
Fraud Validation -Beneficiary cannot receive more than 200,000 soles in a week
document.number
3007
Fraud validation - operation rejected due to anti-fraud rules
-
Rejections Layer 4 (Bank Rejected Codes)
4000
Bank Rejection
4001
Bank Rejection - Beneficiary is not the Account Owner
4002
Bank Rejection - Cancelled Credit Account
4003
Bank Rejection - Blocked Credit Account
4004
Bank Rejection - Account Number not enabled
4005
Bank Rejection - Restricted credit account
4006
Bank Rejection - The document is wrong
4007
Bank Rejection - The interbank code is wrong
4008
Bank Rejection - Bank out of service
4009
Bank Rejection - Credit account is in another currency
4010
Bank Rejection - Credit account type does not allow transfer
4011
Bank Rejection - Incorrect account information
4012
Bank Rejection - Amount exceeds the allowance
4013
Bank Rejection - The AFP account cannot be linked
4014
Bank Rejection - Product credit account not enabled
4015
Bank Rejection - Rejected Requested by customer
4016
Bank Rejection - Reason to confirm
4017
Bank Rejection - Information Incomplete
4018
Bank Rejection - Payment type Incorrect
4019
Bank Rejection - Incorrect Character
4020
Bank Rejection - Incorrect Information structure
4021
Bank Rejection - Rejection by agreement with the beneficiary
4022
Bank Rejection - Duplicated Order
4023
Bank Rejection - Bank Code Incorrect
4024
Bank Rejection - Beneficiary cannot receive payments
4025
Bank Rejection - Account Number does not exist
4026
Bank Rejection - Expired payment order
4027
Bank Rejection - Directory does not exist as available
Last updated