Getnet DocsGetnet Docs

Errors

When facing error scenarios, the Getnet API will provide a status_code property with an error code value that can be used to find its corresponding description, helping you better understand the nature of the error.

Below are the possible error code values and their corresponding descriptions.

Credit/Debit Errors

400-Bad Request

Error codeDescription
PAYMENTS-012Input amount greater than or equal to the transaction amount
PAYMENTS-013Invalid portion amount
PAYMENTS-015Contact issuer
PAYMENTS-016Invalid NSU
PAYMENTS-019Invalid card issue date
PAYMENTS-020Invalid expiration date
PAYMENTS-024Transaction undone
PAYMENTS-025Invalid authentication
PAYMENTS-026Invalid authorization
PAYMENTS-029Invalid pre-authorization
PAYMENTS-044Format error
PAYMENTS-050Contact the institution
PAYMENTS-051Parameterized negative response
PAYMENTS-054Pending confirmation
PAYMENTS-055Transaction cancelled
PAYMENTS-056Transaction not allowed in this cycle
PAYMENTS-058Reverse transaction
PAYMENTS-060Card required in the transaction
PAYMENTS-061Generic rejection
PAYMENTS-066Invalid payment method
PAYMENTS-068Invalid card digit
PAYMENTS-069Repeated transaction
PAYMENTS-070Card number does not check
PAYMENTS-072Non-cancellable transaction
PAYMENTS-073Transaction already cancelled
PAYMENTS-078Invalid data on cancellation
PAYMENTS-079Invalid cancellation amount
PAYMENTS-080Invalid card
PAYMENTS-081Exceeds date
PAYMENTS-082Invalid cancellation
PAYMENTS-083Use debit function
PAYMENTS-084Use credit function
PAYMENTS-085Transaction already made
PAYMENTS-090Transaction not authorized by the card
PAYMENTS-091Outside the allowed deadline
PAYMENTS-093Authorization is already in process
PAYMENTS-094Authorization to confirm receipt
PAYMENTS-098Unregistered customer
PAYMENTS-117Ask the cardholder to call the issuer
PAYMENTS-118Invalid card or product not enabled
PAYMENTS-999Unprocessed transaction
GENERIC-400Invalid credit card
Validation error
Header validation
Error requesting a cancellation
Service error
Parameter invalid
Argument invalid
Brand code not enabled
Query validation error
CANCEL-400Bad request on a reversal
Denied. Payment already reversed

401-Unauthorized

Error codeDescription
GENERIC-401Unauthorized
CANCEL-401Invalid client credential on a reversal

402-Business errors

Error codeDescription
PAYMENTS-001Value not reported
PAYMENTS-002Invalid card
PAYMENTS-003Expired card
PAYMENTS-004Invalid parameter
PAYMENTS-005Invalid security code
PAYMENTS-006Invalid card brand
PAYMENTS-007Operation not allowed
PAYMENTS-008Invalid data
PAYMENTS-009Minimum value of the invalid installment
PAYMENTS-010Invalid number of installments
PAYMENTS-011Number of installments exceeds limit
PAYMENTS-014Installment payment not allowed
PAYMENTS-022Invalid currency code
PAYMENTS-023Card brand does not belong to the network
PAYMENTS-030Error in user authentication
PAYMENTS-032Denied by the issuer
PAYMENTS-033Invalid establishment
PAYMENTS-034Unauthorized request
PAYMENTS-036Request identification
PAYMENTS-037Transaction in progress
PAYMENTS-038Invalid transaction
PAYMENTS-039Invalid transaction amount
PAYMENTS-041Redo the transaction
PAYMENTS-045Restricted card
PAYMENTS-046Lost card
PAYMENTS-047Stolen card
PAYMENTS-048Card without registration
PAYMENTS-049Transaction not allowed to this customer
PAYMENTS-052Duplicate transaction
PAYMENTS-053Card locked
PAYMENTS-067Threshold value exceeded
PAYMENTS-077Invalid card number
PAYMENTS-096Credit exceeded
PAYMENTS-101Offline Authorizer
PAYMENTS-102Customer with no credit limit
PAYMENTS-103Transaction not authorized by the authorizing network
PAYMENTS-104Integration error
PAYMENTS-105Unauthorized transaction
PAYMENTS-109There is a transaction to be confirmed
PAYMENTS-112Non-existent document to cancel
PAYMENTS-113Insufficient Balance
PAYMENTS-114Exceeds the Approval Value Threshold
PAYMENTS-115Exceeds the Withdrawal Frequency Limit
PAYMENTS-116Authorization refused
SERVICE-402Error capturing credit transaction
Error adjusting credit pre authorization transaction
GENERIC-402Error on creating postponed transaction
Postponed payment is expired
Antifraud denied
Document invalid
Error canceling credit transaction
Error validating business requirements

403-Forbidden

Error codeDescription
GENERIC-403Payment method is not allowed
Brand type is not allowed
Service is not enabled
Invalid token or previously used token
Unauthorized error
PIX product not enabled

404-Not found

Error codeDescription
PAYMENTS-043Record not found
PAYMENTS-057Transaction does not exist
PAYMENTS-076Transaction not available
PAYMENTS-095Authorization not found
GENERIC-404Error on creating postponed transaction
Transaction not found
Register was not found

409-Conflict

Error codeDescription
GENERIC-409The request could not be processed because of conflicting parameters

412-Precondition failed

Error codeDescription
GENERIC-412Parameter was not found
Parameter was not defined

422-Unprocessable content

Error codeDescription
GENERIC-422Unprocessable Entity
No refunds of partial sales, only full refunds allowed
Previously canceled or denied payments cannot be canceled
Partial cancellation can only be made after the capture day
CANCEL-124Denied, violation of law
CANCEL-070Denied. Operation refund not available for authorized transaction
CANCEL-088Denied. Insufficient balance for this transaction

500-Internal server error

Error codeDescription
PAYMENTS-042Invalid response
PAYMENTS-059Local network problem
PAYMENTS-062Institution temporarily out of operation
PAYMENTS-063System malfunction
PAYMENTS-064Database error
PAYMENTS-071Temporarily blocked authorizer
PAYMENTS-086Transaction error
PAYMENTS-099Uninitialized authorizer
PAYMENTS-100Disconnected channel
PAYMENTS-107Communication error
PAYMENTS-500Internal Server Error
GENERIC-500The server encountered an unexpected error

501-Not implemented

Error codeDescription
GENERIC-501Invalid response from the upstream server

503-Service unavailable

Error codeDescription
PAYMENTS-021Issuer System Unavailable - Please Try Again
GENERIC-503The server is currently unable to handle the request, try again later

504-Gateway timeout

Error codeDescription
PAYMENTS-031Timeout
PAYMENTS-089Internal timeout
GENERIC-504Connection timeout

Boleto Errors

402-Business error

Error codeDescription
PAYMENTS-40200001 - Our invalid/incompatible number
00007 - Invalid document species
00016 - Invalid expiration date
00057 - Incorrect drawee ZIP code
00058 - Incorrect CPF/CNPJ
00093 - Title value not reported
00098 - Invalid Issue Date
00100 - Issue date greater than due date
00102 - Address of the drawee not informed
00103 - Municipality of the drawee not informed
00107 - Incorrect federation unit
00113 - Invalid discount amount
00124 - Zip code of the drawee not found
00128 - Invalid protest code
00145 - Invalid document type
00147 - Number of days for invalid protest
00160 - Neighborhood of the drawee not informed
00176 - Record not found
00422 - Inconsistent certificate
00423 - Station is not of the agreement
00424 - Agreement not marked for message exchange for online entry
00425 - Environment marked as test and NSU is not test
00426 - Environment marked as production with test NSU
00427 - Station code does not belong to the agreement
00428 - Agreement is not active
00429 - Invalid discount type
00430 - Exempt with discount value
00431 - Field our non-numeric number
00432 - Client does not have online entry
00433 - Invalid discount deadline

Transactions denied by Antifraud

Error codeDescription
200
250
0700
2000
480
481
Transaction denied by Antifraud system security rule
0150Transaction sent with the “amount” field filled with the null or invalid amount
0902
101
102
Transaction sent with the “required” field filled with the null or invalid amount
231
0400
202
Incorrectly filled in credit card details
400
0330
0500
0600
1300
1800
The credit card issuer did not approve the transaction.
234
0901
0000
0903
150
151
121
500
Unavailability in the Antifraud system. Contact Getnet.

ABECS Return Codes - Brazil

To support commercial establishments in better understanding transaction declines, ABECS (Associação Brasileira das Empresas de Cartões de Crédito e Serviços – Brazilian Association of Credit Card and Services Companies) has updated the return codes. Return codes are classified into two types: irreversible codes, where a different payment method must be requested; and reversible codes, for which the transaction may be resubmitted in accordance with the guidelines outlined in the accompanying spreadsheet. Getnet is fully prepared to provide customers with the corresponding codes listed in the table below.

ABECS CodeCard brandDescriptionPD ReturnCode TypeMessage
00ALLAPROVADA. TRANSACAO EXECUTADA COM SUCESSONANAAPPROVED TRANSACTION
01HIPERCARDVERIFIQUE OS DADOS DO CARTAO [ECOM-01]PAYMENTS-002IRREVERSIBLECARD NUMBER DOES NOT BELONG TO THE ISSUER
01MASTERCARDVERIFIQUE OS DADOS DO CARTAO [ECOM-01]PAYMENTS-002IRREVERSIBLECARD NUMBER DOES NOT BELONG TO THE ISSUER
12HIPERCARDPARCELAMENTO INVALIDO - NAO TENTE NOVAMENTE [ECOM-12]PAYMENTS-002IRREVERSIBLEAMOUNT OF INVALID INSTALLMENT
12MASTERCARDPARCELAMENTO INVALIDO - NAO TENTE NOVAMENTE [ECOM-12]PAYMENTS-002IRREVERSIBLEAMOUNT OF INVALID INSTALLMENT
12ELOVERIFIQUE OS DADOS DO CARTAO [ECOM-12]PAYMENTS-002IRREVERSIBLECARD ERROR
64ELOVALOR DA TRANSACAO NAO PERMITIDO - NAO TENTE NOVAMENTE [ECOM-64]PAYMENTS-039IRREVERSIBLEINVALID MINIMUM TRANSACTION AMOUNT
76ELOCONTA DESTINO INVALIDA - NAO TENTE NOVAMENTE [ECOM-76]PAYMENTS-034IRREVERSIBLEINVALID OR NON-EXISTENT DESTINATION ACCOUNT
912AMEXFALHA DE COMUNICACAO - TENTE MAIS TARDE [ECOM-912]PAYMENTS-021IRREVERSIBLEOFF-AIR EMITTER
911AMEXFALHA DE COMUNICACAO - TENTE MAIS TARDE [ECOM-911]PAYMENTS-021IRREVERSIBLESYSTEM FAILURE
04ELOREFAZER A TRANSACAO [ECOM-04]PAYMENTS-034REVERSIBLEGENERIC
06ELOLOJISTA CONTATE O ADQUIRENTE [ECOM-06]PAYMENTS-002REVERSIBLEREDO THE TRANSACTION (ISSUER REQUESTS RETRY)
R1VISASUSPENSAO DE PAGAMENTO RECORRENTE PARA SERVICO - NAO TENTE NOVAMENTE [ECOM-R1]PAYMENTS-605IRREVERSIBLESUSPENSION OF RECURRING PAYMENT FOR ALL SERVICE
04VISACONTATE A CENTRAL DO SEU CARTAO - NAO TENTE NOVAMENTE [ECOM-04]PAYMENTS-034IRREVERSIBLECOLLECT CARD (NO FRAUD)
100AMEXCONTATE A CENTRAL DO SEU CARTAO [ECOM-100]PAYMENTS-116REVERSIBLEGENERIC
101AMEXVERIFIQUE OS DADOS DO CARTAO [ECOM-101]PAYMENTS-002IRREVERSIBLEEXPIRED CARD / DT INVALID EXPIRATION
106AMEXEXCEDIDAS TENTATIVAS DE SENHA. CONTATE A CENTRAL DO SEU CARTAO [ECOM-106]PAYMENTS-008REVERSIBLEPASSWORD ATTEMPTS EXCEEDED
109AMEXTRANSACAO NAO PERMITIDA - NAO TENTE NOVAMENTE [ECOM-109]PAYMENTS-049IRREVERSIBLEINVALID MERCHANT
110AMEXVALOR DA TRANSACAO NAO PERMITIDO - NAO TENTE NOVAMENTE [ECOM-110]PAYMENTS-039IRREVERSIBLEINVALID TRANSACTION AMOUNT
115AMEXVERIFIQUE OS DADOS DO CARTAO [ECOM-115]PAYMENTS-002IRREVERSIBLECARD ERROR
116AMEXNAO AUTORIZADA [ECOM-116]PAYMENTS-113REVERSIBLEINSUFFICIENT BALANCE/LIMIT
117AMEXSENHA INVALIDA [ECOM-117]PAYMENTS-008REVERSIBLEINVALID PASSWORD
122AMEXVERIFIQUE OS DADOS DO CARTAO [ECOM-122]PAYMENTS-002IRREVERSIBLECARD NUMBER DOES NOT BELONG TO THE ISSUER
03HIPERCARDTRANSACAO NAO PERMITIDA - NAO TENTE NOVAMENTE [ECOM-03]PAYMENTS-049IRREVERSIBLEINVALID MERCHANT
43HIPERCARDTRANSACAO NAO PERMITIDA - NAO TENTE NOVAMENTE [ECOM-43]PAYMENTS-049IRREVERSIBLESTOLEN CARD
43VISATRANSACAO NAO PERMITIDA - NAO TENTE NOVAMENTE [ECOM-43]PAYMENTS-049IRREVERSIBLESTOLEN CARD
04MASTERCARDTRANSACAO NAO PERMITIDA PARA O CARTAO - NAO TENTE NOVAMENTE [ECOM-04]PAYMENTS-034IRREVERSIBLECONFIRMED FRAUD
04HIPERCARDTRANSACAO NAO PERMITIDA PARA O CARTAO - NAO TENTE NOVAMENTE [ECOM-04]PAYMENTS-034IRREVERSIBLECONFIRMED FRAUD
05ELOCONTATE A CENTRAL DO SEU CARTAO [ECOM-05]PAYMENTS-116REVERSIBLECONSULT ACCREDITOR
05VISACONTATE A CENTRAL DO SEU CARTAO [ECOM-05]PAYMENTS-116REVERSIBLEGENERIC
05MASTERCARDCONTATE A CENTRAL DO SEU CARTAO [ECOM-05]PAYMENTS-116REVERSIBLEGENERIC
05HIPERCARDCONTATE A CENTRAL DO SEU CARTAO [ECOM-05]PAYMENTS-116REVERSIBLEGENERIC
06VISAVERIFIQUE OS DADOS DO CARTAO [ECOM-06]PAYMENTS-002IRREVERSIBLECARD NUMBER DOES NOT BELONG TO THE ISSUER
07VISATRANSACAO NAO PERMITIDA PARA O CARTAO - NAO TENTE NOVAMENTE [ECOM-07]PAYMENTS-049IRREVERSIBLECONFIRMED FRAUD
12VISAERRO NO CARTAO – NAO TENTE NOVAMENTE [ECOM-12]PAYMENTS-002IRREVERSIBLEFORMAT ERROR (MESSAGING)
13ELOVALOR DA TRANSACAO NAO PERMITIDO - NAO TENTE NOVAMENTE [ECOM-13]PAYMENTS-039IRREVERSIBLEINVALID TRANSACTION AMOUNT
13HIPERCARDVALOR DA TRANSACAO NAO PERMITIDO - NAO TENTE NOVAMENTE [ECOM-13]PAYMENTS-039IRREVERSIBLEINVALID TRANSACTION AMOUNT
13MASTERCARDVALOR DA TRANSACAO NAO PERMITIDO - NAO TENTE NOVAMENTE [ECOM-13]PAYMENTS-039IRREVERSIBLEINVALID TRANSACTION AMOUNT
13VISAVALOR DA TRANSACAO NAO PERMITIDO - NAO TENTE NOVAMENTE [ECOM-13]PAYMENTS-039IRREVERSIBLEINVALID TRANSACTION AMOUNT
14ELOVERIFIQUE OS DADOS DO CARTAO [ECOM-14]PAYMENTS-002IRREVERSIBLECARD NUMBER DOES NOT BELONG TO THE ISSUER
14HIPERCARDVERIFIQUE OS DADOS DO CARTAO [ECOM-14]PAYMENTS-002IRREVERSIBLESECURITY BREACH
14MASTERCARDVERIFIQUE OS DADOS DO CARTAO [ECOM-14]PAYMENTS-002IRREVERSIBLESECURITY BREACH
14VISAVERIFIQUE OS DADOS DO CARTAO [ECOM-14]PAYMENTS-002REVERSIBLEINVALID CARD
15HIPERCARDDADOS DO CARTAO INVALIDO - NAO TENTE NOVAMENTE [ECOM-15]PAYMENTS-002IRREVERSIBLEISSUER NOT LOCATED - BIN INCORRECT
15VISADADOS DO CARTAO INVALIDO - NAO TENTE NOVAMENTE [ECOM-15]PAYMENTS-002IRREVERSIBLEISSUER NOT LOCATED - BIN INCORRECT
15MASTERCARDDADOS DO CARTAO INVALIDO - NAO TENTE NOVAMENTE [ECOM-15]PAYMENTS-002IRREVERSIBLEISSUER NOT LOCATED - BIN INCORRECT
19ELOERRO NO CARTAO – NAO TENTE NOVAMENTE [ECOM-19]PAYMENTS-002IRREVERSIBLEPROBLEM WITH ACQUIRER
19VISAERRO NO CARTAO – NAO TENTE NOVAMENTE [ECOM-19]PAYMENTS-002IRREVERSIBLEPROBLEM WITH ACQUIRER
23ELOPARCELAMENTO INVALIDO - NAO TENTE NOVAMENTE [ECOM-23]PAYMENTS-011IRREVERSIBLEAMOUNT OF INVALID INSTALLMENT
23MASTERCARDPARCELAMENTO INVALIDO - NAO TENTE NOVAMENTE [ECOM-23]PAYMENTS-011IRREVERSÍVELVALOR DA PARCELA INVÁLIDA
23VISAPARCELAMENTO INVALIDO - NAO TENTE NOVAMENTE [ECOM-23]PAYMENTS-011IRREVERSÍVELVALOR DA PARCELA INVÁLIDA
30ELOERRO NO CARTAO – NAO TENTE NOVAMENTE [ECOM-30]PAYMENTS-002IRREVERSIBLEFORMAT ERROR (MESSAGING)
30MASTERCARDERRO NO CARTAO – NAO TENTE NOVAMENTE [ECOM-30]PAYMENTS-002IRREVERSIBLEPROBLEM WITH ACQUIRER
30HIPERCARDERRO NO CARTAO – NAO TENTE NOVAMENTE [ECOM-30]PAYMENTS-002IRREVERSIBLEPROBLEM WITH ACQUIRER
30VISAERRO NO CARTAO – NAO TENTE NOVAMENTE [ECOM-30]PAYMENTS-002IRREVERSÍVELPROBLEMA NO ADQUIRENTE
38ELOEXCEDIDAS TENTATIVAS DE SENHA. CONTATE A CENTRAL DO SEU CARTAO [ECOM-38]PAYMENTS-008REVERSIBLEPASSWORD ATTEMPTS EXCEEDED
39VISAUTILIZE FUNCAO DEBITO [ECOM-39]PAYMENTS-083IRREVERSIBLEINCORRECT FUNCTION (CREDIT)
41HIPERCARDTRANSACAO NAO PERMITIDA - NAO TENTE NOVAMENTE [ECOM-41]PAYMENTS-049IRREVERSIBLELOST CARD
41MASTERCARDTRANSACAO NAO PERMITIDA - NAO TENTE NOVAMENTE [ECOM-41]PAYMENTS-049IRREVERSIBLELOST CARD
41ELOTRANSACAO NAO PERMITIDA - NAO TENTE NOVAMENTE [ECOM-41]PAYMENTS-049IRREVERSIBLECARTÃO PERDIDO
41VISATRANSACAO NAO PERMITIDA - NAO TENTE NOVAMENTE [ECOM-41]PAYMENTS-049IRREVERSIBLELOST CARD
43MASTERCARDTRANSACAO NAO PERMITIDA - NAO TENTE NOVAMENTE [ECOM-43]PAYMENTS-049IRREVERSIBLESTOLEN CARD
43ELOTRANSACAO NAO PERMITIDA - NAO TENTE NOVAMENTE [ECOM-43]PAYMENTS-049IRREVERSIBLESTOLEN CARD
53VISAUTILIZE FUNCAO CREDITO [ECOM-53]PAYMENTS-084IRREVERSIBLEINCORRECT FUNCTION (DEBIT)
56ELOVERIFIQUE OS DADOS DO CARTAO [ECOM-56]PAYMENTS-002IRREVERSIBLECARD NUMBER DOES NOT BELONG TO THE ISSUER
51VISANAO AUTORIZADA [ECOM-51]PAYMENTS-113REVERSIBLEINSUFFICIENT BALANCE/LIMIT
51MASTERCARDNAO AUTORIZADA [ECOM-51]PAYMENTS-113REVERSIBLEINSUFFICIENT BALANCE/LIMIT
51HIPERCARDNAO AUTORIZADA [ECOM-51]PAYMENTS-113REVERSIBLEINSUFFICIENT BALANCE/LIMIT
51ELONAO AUTORIZADA [ECOM-51]PAYMENTS-113REVERSIBLEINSUFFICIENT BALANCE/LIMIT
52VISAUTILIZE FUNCAO CREDITO [ECOM-52]PAYMENTS-084IRREVERSIBLEINCORRECT FUNCTION (DEBIT)
61VISAVALOR EXCEDIDO. CONTATE A CENTRAL DO SEU CARTAO [ECOM-61]PAYMENTS-114REVERSIBLEEXCESS VALUE
54HIPERCARDVERIFIQUE OS DADOS DO CARTAO [ECOM-54]PAYMENTS-002IRREVERSIBLEEXPIRED CARD / DT INVALID EXPIRATION
54MASTERCARDVERIFIQUE OS DADOS DO CARTAO [ECOM-54]PAYMENTS-002IRREVERSIBLEEXPIRED CARD / DT INVALID EXPIRATION
54ELOVERIFIQUE OS DADOS DO CARTAO [ECOM-54]PAYMENTS-002IRREVERSIBLEEXPIRED CARD / DT INVALID EXPIRATION
54VISAVERIFIQUE OS DADOS DO CARTAO [ECOM-54]PAYMENTS-002IRREVERSIBLEEXPIRED CARD / DT INVALID EXPIRATION
55VISASENHA INVALIDA [ECOM-55]PAYMENTS-008REVERSIBLEINVALID PASSWORD
55HIPERCARDSENHA INVALIDA [ECOM-55]PAYMENTS-008REVERSIBLEINVALID PASSWORD
55ELOSENHA INVALIDA [ECOM-55]PAYMENTS-008REVERSIBLEINVALID PASSWORD
55MASTERCARDSENHA INVALIDA [ECOM-55]PAYMENTS-008REVERSIBLEINVALID PASSWORD
61ELOVALOR EXCEDIDO. CONTATE A CENTRAL DO SEU CARTAO [ECOM-61]PAYMENTS-114REVERSIBLEEXCESS VALUE
57MASTERCARDTRANSACAO NAO PERMITIDA PARA O CARTAO - NAO TENTE NOVAMENTE [ECOM-57]PAYMENTS-049IRREVERSIBLETRANSACTION NOT ALLOWED FOR THE CARD
57HIPERCARDTRANSACAO NAO PERMITIDA PARA O CARTAO - NAO TENTE NOVAMENTE [ECOM-57]PAYMENTS-049IRREVERSIBLETRANSACTION NOT ALLOWED FOR THE CARD
57VISATRANSACAO NAO PERMITIDA PARA O CARTAO - NAO TENTE NOVAMENTE [ECOM-57]PAYMENTS-049IRREVERSIBLETRANSACTION NOT ALLOWED FOR THE CARD
57ELOTRANSACAO NAO PERMITIDA PARA O CARTAO - NAO TENTE NOVAMENTE [ECOM-57]PAYMENTS-049IRREVERSIBLETRANSACTION NOT ALLOWED FOR THE CARD
58HIPERCARDTRANSACAO NAO PERMITIDA PARA O CARTAO - NAO TENTE NOVAMENTE [ECOM-58]PAYMENTS-049IRREVERSIBLETRANSACTION NOT ALLOWED
58ELOTRANSACAO NAO PERMITIDA PARA O CARTAO - NAO TENTE NOVAMENTE [ECOM-58]PAYMENTS-049IRREVERSIBLEINVALID MERCHANT
58MASTERCARDTRANSACAO NAO PERMITIDA PARA O CARTAO - NAO TENTE NOVAMENTE [ECOM-58]PAYMENTS-049IRREVERSIBLETRANSACTION NOT ALLOWED
58VISATRANSACAO NAO PERMITIDA PARA O CARTAO - NAO TENTE NOVAMENTE [ECOM-58]PAYMENTS-049IRREVERSIBLETRANSACTION NOT ALLOWED
59VISACONTATE A CENTRAL DO SEU CARTAO [ECOM-59]PAYMENTS-002REVERSIBLESUSPECTED FRAUD
59ELOCONTATE A CENTRAL DO SEU CARTAO [ECOM-59]PAYMENTS-002REVERSIBLESUSPECTED FRAUD
61MASTERCARDVALOR EXCEDIDO. CONTATE A CENTRAL DO SEU CARTAO [ECOM-61]PAYMENTS-114REVERSIBLEEXCESS VALUE
61HIPERCARDVALOR EXCEDIDO.CONT ATE A CENTRAL DO SEU CARTAO [ECOM-61]PAYMENTS-114REVERSIBLEEXCESS VALUE
76VISACONTATE A CENTRAL DO SEU CARTAO - NAO TENTE NOVAMENTE [ECOM-76]PAYMENTS-034IRREVERSIBLEINVALID REVERSAL
77ELOCONTA ORIGEM INVALIDA - NAO TENTE NOVAMENTE [ECOM-77]PAYMENTS-600IRREVERSIBLEINVALID OR NON-EXISTENT SOURCE ACCOUNT
62ELOCARTAO NAO PERMITE TRANSACAO INTERNACIONAL [ECOM-62]PAYMENTS-045IRREVERSIBLEDOMESTIC CARD - INTERNATIONAL TRANSACTION
62VISACARTAO NAO PERMITE TRANSACAO INTERNACIONAL [ECOM-62]PAYMENTS-045IRREVERSIBLEDOMESTIC CARD - INTERNATIONAL TRANSACTION
62MASTERCARDCARTAO NAO PERMITE TRANSACAO INTERNACIONAL [ECOM-62]PAYMENTS-045IRREVERSIBLEDOMESTIC CARD - INTERNATIONAL TRANSACTION
62HIPERCARDCARTAO NAO PERMITE TRANSACAO INTERNACIONAL [ECOM-62]PAYMENTS-045IRREVERSIBLEDOMESTIC CARD - INTERNATIONAL TRANSACTION
63ELOVERIFIQUE OS DADOS DO CARTAO [ECOM-63]PAYMENTS-002IRREVERSIBLESECURITY BREACH
63VISAVERIFIQUE OS DADOS DO CARTAO [ECOM-63]PAYMENTS-002REVERSIBLEINVALID CARD
63HIPERCARDVERIFIQUE OS DADOS DO CARTAO [ECOM-63]PAYMENTS-002REVERSIBLESUSPECTED FRAUD
63MASTERCARDVERIFIQUE OS DADOS DO CARTAO [ECOM-63]PAYMENTS-002REVERSIBLESUSPECTED FRAUD
64VISACONTATE A CENTRAL DO SEU CARTAO - NAO TENTE NOVAMENTE [ECOM-64]PAYMENTS-039IRREVERSIBLE(buyer’s denial) FAILURE TO COMPLY WITH ANTI-MONEY LAUNDERING LAWS
64AMEXPARCELADO NAO PERMITIDO PARA CARTAO [ECOM - 64]PAYMENTS-014IRREVERSÍVELPARCELADO NAO PERMITIDO PARA CARTAO
64MASTERCARDPARCELADO NAO PERMITIDO PARA CARTAO [ECOM - 64]PAYMENTS-014IRREVERSÍVELPARCELADO NAO PERMITIDO PARA CARTAO
65VISAQTDADE DE SAQUES EXCEDIDA. CONTATE A CENTRAL DO SEU CARTAO [ECOM-65]PAYMENTS-115REVERSIBLEAMOUNT OF WITHDRAWALS EXCEEDED
65ELOQTDADE DE SAQUES EXCEDIDA. CONTATE A CENTRAL DO SEU CARTAO [ECOM-65]PAYMENTS-115REVERSIBLEAMOUNT OF WITHDRAWALS EXCEEDED
68AMEXTIMEOUTPAYMENTS-031REVERSÍVELTIMEOUT
68ELOTIMEOUTPAYMENTS-031REVERSÍVELTIMEOUT
65MASTERCARDQTDADE DE SAQUES EXCEDIDA. CONTATE A CENTRAL DO SEU CARTAO [ECOM-65]PAYMENTS-115REVERSIBLEAMOUNT OF WITHDRAWALS EXCEEDED
65HIPERCARDQTDADE DE SAQUES EXCEDIDA. CONTATE A CENTRAL DO SEU CARTAO [ECOM-65]PAYMENTS-115REVERSIBLEAMOUNT OF WITHDRAWALS EXCEEDED
74VISASENHA INVALIDA - NAO TENTE NOVAMENTE [ECOM-74]PAYMENTS-008IRREVERSIBLEPASSWORD EXPIRED / PASSWORD ENCRYPTION ERROR
74ELOSENHA INVALIDA - NAO TENTE NOVAMENTE [ECOM-74]PAYMENTS-008IRREVERSIBLEPASSWORD EXPIRED / PASSWORD ENCRYPTION ERROR
75HIPERCARDEXCEDIDAS TENTATIVAS DE SENHA. CONTATE A CENTRAL DO SEU CARTAO [ECOM-75]PAYMENTS-008REVERSIBLEPASSWORD ATTEMPTS EXCEEDED
75ELOEXCEDIDAS TENTATIVAS DE SENHA. CONTATE A CENTRAL DO SEU CARTAO [ECOM-75]PAYMENTS-008REVERSIBLEPASSWORD ATTEMPTS EXCEEDED
75MASTERCARDEXCEDIDAS TENTATIVAS DE SENHA. CONTATE A CENTRAL DO SEU CARTAO [ECOM-75]PAYMENTS-008REVERSIBLEPASSWORD ATTEMPTS EXCEEDED
75VISAEXCEDIDAS TENTATIVAS DE SENHA. CONTATE A CENTRAL DO SEU CARTAO [ECOM-75]PAYMENTS-008REVERSIBLEPASSWORD ATTEMPTS EXCEEDED
78ELODESBLOQUEIE O CARTAO [ECOM-78]PAYMENTS-053REVERSIBLENEW CARD WITHOUT UNLOCKING
78VISADESBLOQUEIE O CARTAO [ECOM-78]PAYMENTS-053REVERSIBLENEW CARD WITHOUT UNLOCKING
78MASTERCARDDESBLOQUEIE O CARTAO [ECOM-78]PAYMENTS-053REVERSIBLENEW CARD WITHOUT UNLOCKING
81VISASENHA INVALIDA - NAO TENTE NOVAMENTE [ECOM-81]PAYMENTS-008IRREVERSIBLEPASSWORD EXPIRED / PASSWORD ENCRYPTION ERROR
88HIPERCARDSENHA INVALIDA - NAO TENTE NOVAMENTE [ECOM-88]PAYMENTS-008IRREVERSIBLEPASSWORD EXPIRED / PASSWORD ENCRYPTION ERROR
88MASTERCARDSENHA INVALIDA - NAO TENTE NOVAMENTE [ECOM-88]PAYMENTS-008IRREVERSIBLEPASSWORD EXPIRED / PASSWORD ENCRYPTION ERROR
82ELOERRO NO CARTAO – NAO TENTE NOVAMENTE [ECOM-82]PAYMENTS-002IRREVERSIBLEINVALID CARD (cryptogram)
82VISAERRO NO CARTAO – NAO TENTE NOVAMENTE [ECOM-82]PAYMENTS-002IRREVERSIBLEINVALID CARD (cryptogram)
86HIPERCARDSENHA INVALIDA [ECOM-86]PAYMENTS-008REVERSIBLEINVALID PASSWORD
86VISASENHA INVALIDA [ECOM-86]PAYMENTS-008REVERSIBLEINVALID PASSWORD
86MASTERCARDSENHA INVALIDA [ECOM-86]PAYMENTS-008REVERSIBLEINVALID PASSWORD
P6ELOSENHA INVALIDA UTILIZE A NOVA SENHA [ECOM-P6]PAYMENTS-008REVERSIBLENEW PASSWORD NOT ACCEPTED
03VISATRANSACAO NAO PERMITIDA - NAO TENTE NOVAMENTE [ECOM-03]PAYMENTS-049IRREVERSIBLEINVALID MERCHANT
91HIPERCARDFALHA DE COMUNICACAO - TENTE MAIS TARDE [ECOM-91]PAYMENTS-021REVERSIBLEOFF-AIR EMITTER
91VISAFALHA DE COMUNICACAO - TENTE MAIS TARDE [ECOM-91]PAYMENTS-021REVERSIBLEOFF-AIR EMITTER
91ELOFALHA DE COMUNICACAO - TENTE MAIS TARDE [ECOM-91]PAYMENTS-021REVERSIBLEOFF-AIR EMITTER
91MASTERCARDFALHA DE COMUNICACAO - TENTE MAIS TARDE [ECOM-91]PAYMENTS-021REVERSIBLEOFF-AIR EMITTER
91AMEXFALHA DE COMUNICACAO - TENTE MAIS TARDE [ECOM-91]PAYMENTS-021REVERSÍVELEMISSOR FORA DO AR
92VISACONTATE A CENTRAL DO SEU CARTAO - NAO TENTE NOVAMENTE [ECOM-92]PAYMENTS-034IRREVERSIBLENOT LOCATED BY ROUTER
92MASTERCARDCONTATE A CENTRAL DO SEU CARTAO - NAO TENTE NOVAMENTE [ECOM-92]PAYMENTS-034IRREVERSIBLENOT LOCATED BY ROUTER
92HIPERCARDCONTATE A CENTRAL DO SEU CARTAO - NAO TENTE NOVAMENTE [ECOM-92]PAYMENTS-034IRREVERSIBLENOT LOCATED BY ROUTER
93VISATRANSACAO NAO PERMITIDA PARA O CARTAO - NAO TENTE NOVAMENTE [ECOM-93]PAYMENTS-049IRREVERSIBLETRANSACTION DENIED FOR BREACH OF LAW
94VISACONTATE A CENTRAL DO SEU CARTAO - NAO TENTE NOVAMENTE [ECOM-94]PAYMENTS-034IRREVERSIBLEDUPLICATE DATE TRACING VALUE
94MASTERCARDCONTATE A CENTRAL DO SEU CARTAO - NAO TENTE NOVAMENTE [ECOM-94]PAYMENTS-034IRREVERSIBLEDUPLICATE DATE TRACING VALUE
94HIPERCARDCONTATE A CENTRAL DO SEU CARTAO - NAO TENTE NOVAMENTE [ECOM-94]PAYMENTS-034IRREVERSIBLEDUPLICATE DATE TRACING VALUE
96MASTERCARDFALHA DE COMUNICACAO - TENTE MAIS TARDE [ECOM-96]PAYMENTS-021REVERSIBLESYSTEM FAILURE
96HIPERCARDFALHA DE COMUNICACAO - TENTE MAIS TARDE [ECOM-96]PAYMENTS-021REVERSIBLESYSTEM FAILURE
96VISAFALHA DE COMUNICACAO - TENTE MAIS TARDE [ECOM-96]PAYMENTS-021REVERSIBLESYSTEM FAILURE
96ELOFALHA DE COMUNICACAO - TENTE MAIS TARDE [ECOM-96]PAYMENTS-021REVERSIBLESYSTEM FAILURE
99ELOVALOR DIFERENTE DA PRE AUTORIZACAO - NAO TENTE NOVAMENTE [ECOM-99]PAYMENTS-601IRREVERSIBLEDIFFERENCE - PRE-AUTHORIZATION
ABELOUTILIZE FUNCAO CREDITO [ECOM-AB]PAYMENTS-084IRREVERSIBLEINCORRECT FUNCTION (DEBIT)
ACELOUTILIZE FUNCAO DEBITO [ECOM-AC]PAYMENTS-083IRREVERSIBLEINCORRECT FUNCTION (CREDIT)
B1VISACONTATE A CENTRAL DO SEU CARTAO [ECOM-B1]PAYMENTS-002REVERSIBLESURCHARGE NOT SUPPORTED
B2VISACONTATE A CENTRAL DO SEU CARTAO [ECOM-B2]PAYMENTS-002REVERSIBLESURCHARGE NOT SUPPORTED BY THE DEBIT NETWORK
N0VISACONTATE A CENTRAL DO SEU CARTAO [ECOM-N0]PAYMENTS-002REVERSIBLEFORCE STIP
N3VISASAQUE NAO DISPONÍVEL - NAO TENTE NOVAMENTE [ECOM-N3]PAYMENTS-604IRREVERSIBLEWITHDRAWAL NOT AVAILABLE
N4VISAVALOR EXCEDIDO. CONTATE A CENTRAL DO SEU CARTAO [ECOM-N4]PAYMENTS-114REVERSIBLEEXCESS VALUE
N7VISAVERIFIQUE OS DADOS DO CARTAO [ECOM - N7]PAYMENTS-005IRREVERSIBLECVV2 FAILED / INVALID
N8VISAVALOR DIFERENTE DA PRE AUTORIZACAO - NAO TENTE NOVAMENTE [ECOM-N8]PAYMENTS-601IRREVERSIBLEDIFFERENCE - PRE-AUTHORIZATION
P5ELOSENHA INVALIDA - NAO TENTE NOVAMENTE [ECOM-P5]PAYMENTS-008IRREVERSIBLETROCA DE SENHA / DESBLOQUEIO
03MASTERCARDTRANSACAO NAO PERMITIDA - NAO TENTE NOVAMENTE [ECOM-03]PAYMENTS-049IRREVERSIBLEINVALID MERCHANT
R0VISASUSPENSAO DE PAGAMENTO RECORRENTE PARA SERVICO - NAO TENTE NOVAMENTE [ECOM-R0]PAYMENTS-605IRREVERSIBLESUSPENSION OF RECURRING PAYMENT FOR A SERVICE
R2VISATRANSACAO NAO PERMITIDA PARA O CARTAO - NAO TENTE NOVAMENTE [ECOM-R2]PAYMENTS-049IRREVERSIBLETRANSACTION NOT ELIGIBLE FOR VISA PIN
R3VISASUSPENSAO DE PAGAMENTO RECORRENTE PARA SERVICO - NAO TENTE NOVAMENTE [ECOM-R3]PAYMENTS-605IRREVERSIBLESUSPENSION OF ALL AUTHORISATION ORDERS
180AMEXSENHA INVALIDA - NAO TENTE NOVAMENTE [ECOM-180]PAYMENTS-008IRREVERSIBLEPASSWORD EXPIRED / PASSWORD ENCRYPTION ERROR
181AMEXERRO NO CARTAO – NAO TENTE NOVAMENTE [ECOM-181]PAYMENTS-002IRREVERSIBLEFORMAT ERROR (MESSAGING)
200AMEXTRANSACAO NAO PERMITIDA PARA O CARTAO - NAO TENTE NOVAMENTE [ECOM-200]PAYMENTS-049IRREVERSIBLETRANSACTION NOT ALLOWED FOR THE CARD
6PVISAVERIFIQUE OS DADOS DO CARTAO ADQ 4-6PPAYMENTS-077IRREVERSIBLECheck the Card details
46VISATRANSACAO NAO PERMITIDA PARA O CARTAO - NAO TENTE NOVAMENTEPAYMENTS-054IRREVERSIBLEACCOUNT CLOSED
46ELOTRANSACAO NAO PERMITIDA PARA O CARTAO - NAO TENTE NOVAMENTEPAYMENTS-054IRREVERSIBLEACCOUNT CLOSED
82MASTERCARDERRO NO CARTAO – NAO TENTE NOVAMENTE [ECOM-82]PAYMENTS-077IRREVERSIBLECARD ERROR – DON’T TRY AGAIN
121AMEXERRO NO CARTAO – NAO TENTE NOVAMENTE [ECOM-121]PAYMENTS-077IRREVERSIBLECARD WITH ERROR
79MASTERCARDERRO NO CARTAO – NAO TENTE NOVAMENTE ADQ 4-79PAYMENTS-077IRREVERSIBLECARD ERROR – DON’T TRY AGAIN
83MASTERCARDERRO NO CARTAO – NAO TENTE NOVAMENTE ADQ 4-83PAYMENTS-077IRREVERSIBLECARD ERROR – DON’T TRY AGAIN
70VISAVERIFIQUE OS DADOS DO CARTAO [ECOM - 70]PAYMENTS-070REVERSIBLECHECK THE CARD DATA
70MASTERCARDVERIFIQUE OS DADOS DO CARTAO [ECOM - 70]PAYMENTS-070REVERSÍVELVERIFIQUE OS DADOS DO CARTAO
111AMEXDESBLOQUEIE O CARTAO [ECOM - 111]PAYMENTS-111IRREVERSIBLEUNLOCK THE CARD
G3GETNETESTABELECIMENTO NAO CADASTRADO LIGUE GETNET [ECOM-G3]PAYMENTS-033REVERSIBLECONTACT GETNET
G4GETNETCARTAO INVALIDO [ECOM-G4]PAYMENTS-077IRREVERSIBLEINVALID CARD
G5GETNETPRODUTO NAO HABILITADO [ECOM-G5]PAYMENTS-049REVERSIBLECONTACT GETNET
RTGETNETTRANSACAO REJEITADA ENTRAR EM CONTATO COM A GETNET [ECOM-RT]PAYMENTS-701REVERSIBLEUNAUTHORIZED TRANSACTION
REGETNETTRANSACAO NAO AUTORIZADA LIMITE DE TENTATIVAS EXCEDIDO [ECOM-RE]PAYMENTS-701IRREVERSIBLEUNAUTHORIZED TRANSACTION
MDGETNETTRANSACAO NÃO AUTORIZADA ENTRAR EM CONTATO COM A GETNET [ECOM-MD]PAYMENTS-701REVERSIBLEUNAUTHORIZED TRANSACTION
TAGETNETTRANSACAO REJEITADA ENTRAR EM CONTATO COM A GETNET [ECOM-TA]PAYMENTS-701REVERSIBLEUNAUTHORIZED TRANSACTION
MBGETNETTRANSACAO NÃO PERMITIDA REGRAS DE BANDEIRA. NÃO TENTE NOVAMENTE [ECOM-MB]PAYMENTS-701IRREVERSIBLEUNAUTHORIZED TRANSACTION
BPGETNETTRANSACAO NÃO PERMITIDA ESTABELECIMENTO BLOQUEADO [ECOM-BP]PAYMENTS-701IRREVERSIBLEUNAUTHORIZED TRANSACTION
NWGETNETTRANSACAO NÃO PERMITIDA REGRAS DE BANDEIRA. NÃO TENTE NOVAMENTE [ECOM-NW]PAYMENTS-701IRREVERSIBLEUNAUTHORIZED TRANSACTION
46MASTERCARDTRANSACAO NAO PERMITIDA – NAO TENTE NOVAMENTE [ECOM-46]PAYMENTS-707IRREVERSIBLETRANSACTION NOT ALLOWED – DO NOT TRY AGAIN
72MASTERCARDCONTA INDISPONIVEL – CONTATE A CENTRAL DO SEU CARTAO [ECOM-72]PAYMENTS-708IRREVERSIBLEACCOUNT UNAVAILABLE – CONTACT YOUR CARD CENTER
5CVISATRANSACAO NAO PERMITIDA CONTATE A CENTRAL DO SEU CARTAO [ECOM-5C]PAYMENTS-709IRREVERSIBLETRANSACTION NOT ALLOWED CONTACT YOUR CARD CENTER
9GVISACONTATE A CENTRAL DO SEU CARTAO [ECOM-9G]PAYMENTS-710IRREVERSIBLECONTACT YOUR CARD CENTER
15ELOVERIFIQUE OS DADOS DO CARTAOPAYMENTS-080IRREVERSIBLEVERIFIQUE OS DADOS DO CARTAO
66ELOCONTATE A CENTRAL DO SEU CARTAOPAYMENTS-015IRREVERSIBLECONTACT YOUR CARD CENTER
93ELOCONTATE A CENTRAL DO SEU CARTAOPAYMENTS-016IRREVERSIBLECONTACT YOUR CARD CENTER
80ELOVERIFIQUE OS DADOS DO CARTAOPAYMENTS-043IRREVERSIBLEVERIFIQUE OS DADOS DO CARTAO
81ELOBLOQUEIO DE FUNÇÃO - PORTADOR [ECOM-81]—IRREVERSIBLE
(unless the card/function is unlocked)
UNLOCK THE FUNCTION/CARD

Merchant Advice Code (MAC) Mastercard

To prevent the exposure of specific reasons for authorization denials to potential fraudsters, Mastercard has introduced three unique response codes, as outlined in the ABECS returns table above. When an issuer declines an authorization and sends a sensitive response code, Mastercard converts the original issuer code into one of the following tree new codes:

  • 79 (Life Cycle)
  • 82 (Politics)
  • 83 (Fraud/Security)

The acquirer and the merchant will receive only the unique Mastercard code in the authorization response.

Without access to the specific reason for the denial, additional information is required for the merchant to determine whether the decline is reversible, and whether they should attempt the authorization again. To address this, Mastercard has introduced a new code: the MAC – Merchant Advice Code.

The MAC code indicates whether the merchant should retry the transaction and, if so, whether any action is required prior to doing so. The possible MAC code values are as follows: 01 – Updated/Additional information required 02 – Try again later 03 – Do not attempt again 04 – Token requirements not fulfilled for this token type U – Payment cancellation – Do not resubmit transaction

In cases where the response code is 51 (Insufficient Balance/Limit), Mastercard may also include additional advice in the MAC code field, specifying the time after which the transaction may be retried. The initial return number indicates the time unit: a value of 1 represents hours, and a value of 2 represents days, as outlined below: 101 = 1 hour 124 = 24 hours 202 = 2 days 204 = 4 days 206 = 6 days 208 = 8 days 210 = 10 days

The MAC code will be provided in the merchant_advice_code field, which is included in the 200 response schema for all card payments.

FROM TO Mastercard x Getnet

Getnet performs a FROM TO mapping of the original codes received from the Mastercard network to better group the returns according to similar rules for other card networks. Therefore, in the table below, you will find the FROM TO mapping performed:

MAC MastercardFROM TO MAC GetnetDescriptionClassification
0101Updated/additional information neededReversible
0202Try Again LaterReversible
0303Do Not Try AgainIrreversible
0404Token requirements not fulfilled for tdis token typeReversible
21UPayment Cancellation – Do not resubmit transactionReversible
24101Try after 1 hourReversible
25124Try after 24 hoursReversible
26202Try after 2 daysReversible
27204Try after 4 daysReversible
28206Try after 6 daysReversible
29208Try after 8 daysReversible
30210Try after 10 daysReversible
NXNXDo Not Try AgainIrreversible
NVNVTry Again LaterReversible
NUNUTry after 10 daysReversible

Examples of Combinations of Response Codes with MAC Complementary Codes

The table below outlines the possible combinations of MAC codes, along with the response codes that may be sent by Mastercard. It also provides a description of the advice that can be derived from these codes. MAC codes 101, 124, 202, 204, 206, 208, and 210 are for exclusive use by Mastercard. The remaining MAC codes (01, 02, 03, 04, and U) may also be sent by issuers as advisory messages alongside other ABECS codes. In cases where these codes are received, it is important to verify whether the transaction can be retried. To do so, refer to the FROM TO MASTERCARD X GETNET mapping table: if the MAC code indicates that the transaction is reversible, it can be retried; if the MAC code indicates it is irreversible, the transaction cannot be retried.

Response CodeMacDescriptionCounsellingClassification
79 or 8201Updated/additional information neededUpdated information available in the Mastercard ABU database - check the new information before trying againReversible
79 or 8203Do Not Try AgainNo updated credentials found in Mastercard ABU database – do not try againIrreversible
8301Updated/additional information neededVerify that the card information is correct. Authentication can improve the likelihood of approval - try again using authentication (e.g. 3DS)Reversible
8303Do Not Try AgainSuspected fraud. Do not try againIrreversible
79, 82, 8302Try Again LaterPlease try again laterReversible
51101Try after 1 hourPlease try again laterReversible
51124Try after 24 hoursTry after 24 hoursReversible
51202Try after 2 daysTry after 2 daysReversible
51204Try after 4 daysTry after 4 daysReversible
51206Try after 6 daysTry after 6 daysReversible
51208Try after 8 daysTry after 8 daysReversible
51210Try after 10 daysTry after 10 daysReversible