Getnet DocsGetnet Docs

Response Handling

This page describes the codes the API returns to report the outcome of a transaction. There are two distinct types:

  • Raw Response Codes — transmitted directly by card networks via ISO protocol. They appear in the reason_code field and cover both approved and declined transactions.
  • Error Codes — returned by Getnet with a 400 Bad Request HTTP status when a transaction fails validation before reaching the card network.

Raw Response Codes

Raw response codes originate from the card network, not from Getnet. They are transmitted via ISO protocol and reflect the issuer’s authorization decision. These codes cover both successful approvals and declines as they are not HTTP error codes and are unrelated to 400 Bad Request responses.

The code appears in the reason_code field of the API response.

Merchant Advice Code (MAC) — Mastercard

To protect sensitive decline reasons from potential fraudsters, Mastercard uses three unique response codes. When an issuer declines an authorization and sends a sensitive response code, Mastercard converts the original code to one of these three values:

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

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

Without access to the specific decline reason, the merchant needs additional information to determine whether the decline is reversible and whether to retry the authorization. To address this, Mastercard defines the Merchant Advice Code (MAC).

The MAC code indicates whether to retry the transaction and, if so, what action the merchant must take before retrying. The possible MAC values are:

  • 01 — Updated or additional information required
  • 02 — Try again later
  • 03 — Do not retry
  • 04 — Token requirements not fulfilled for this token type
  • U — Payment canceled — do not resubmit

When the response code is 51 (Insufficient Funds/Over Credit Limit), Mastercard may include additional retry-timing advice in the MAC field. The leading digit indicates the time unit: 1 for hours, 2 for days:

  • 101 = 1 hour
  • 124 = 24 hours
  • 202 = 2 days
  • 204 = 4 days
  • 206 = 6 days
  • 208 = 8 days
  • 210 = 10 days

The API returns the MAC code in the merchant_advice_code field of the 200 response for all card payments.

FROM TO Mastercard × Getnet

Getnet maps original Mastercard network codes to internal codes that align with the return-grouping rules used across other card networks.

MAC MastercardFROM TO MAC GetnetDescriptionClassification
0101Updated/additional information neededReversible
0202Try Again LaterReversible
0303Do Not Try AgainIrreversible
0404Token requirements not fulfilled for this 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

Response Code and MAC Combinations

Mastercard exclusively uses MAC codes 101, 124, 202, 204, 206, 208, and 210. Issuers may also send the remaining codes (01, 02, 03, 04, and U) as advisory messages alongside other ABECS return codes. Retry the transaction only when the MAC code marks it as reversible.

Response CodeMACDescriptionGuidanceClassification
79 or 8201Updated/additional information neededUpdated information is available in the Mastercard ABU database. Verify the new details before retrying.Reversible
79 or 8203Do Not Try AgainNo updated credentials found in the Mastercard ABU database. Do not retry.Irreversible
8301Updated/additional information neededVerify that the card information is correct. To improve approval likelihood, retry with authentication (for example, 3DS).Reversible
8303Do Not Try AgainSuspected fraud. Do not retry.Irreversible
79, 82, 8302Try Again LaterTry again later.Reversible
51101Try after 1 hourRetry after 1 hour.Reversible
51124Try after 24 hoursRetry after 24 hours.Reversible
51202Try after 2 daysRetry after 2 days.Reversible
51204Try after 4 daysRetry after 4 days.Reversible
51206Try after 6 daysRetry after 6 days.Reversible
51208Try after 8 daysRetry after 8 days.Reversible
51210Try after 10 daysRetry after 10 days.Reversible

Card Network Response Codes

The table below lists all response codes returned by AMEX, Maestro, Mastercard, and Visa. A dash (—) indicates the code is not used by that brand. Numeric codes are listed first in ascending order, followed by alphanumeric codes.

CodeAMEXMaestroMastercardVisa
0APPROVEDAPPROVAL COMPLETEDAPPROVAL OR COMPLETED SUCCESSFULLYAPPROVAL COMPLETED
1APPROVE WITH IDDECLINE, REFER TO CARD ISSUERREFER TO ISSUERREFER TO CARD ISSUER
2PARTIAL APPROVAL——REFER TO CARD ISSUER - SPECIAL CONDITIONS
3APPROVED VIP—INVALID MERCHANTINVALID MERCHANT OR SERVICE PROVIDER
4—CAPTURE CAPTURE CARDCAPTURE CARDPICK UP CARD
5—DECLINE, MDS USE ONLYDO NOT HONORDO NOT HONOR
6———ERROR
7———PICK UP CARD - SPECIAL CONDITIONS
8——APPROVE WITH ID—
10—MERCHANT TERMINAL CAN ACCEPT PARTIAL APPROVALSPARTIAL APPROVAL AMOUNTAC_APPRV_PART_AMT
11———VIP APPROVAL
12—DECLINE, INVALID TRANSACTIONINVALID TRANSACTIONINVALID TRANSACTION
13—DECLINE, INVALID AMOUNTINVALID AMOUNTINVALID AMOUNT
14—DECLINED, INVALID PANINVALID CARD NUMBERINVALID ACCOUNT NUMBER
15—DECLINE, INVALID ISSUERINVALID ISSUERNO SUCH ISSUER
19———RE-ENTER TRANSACTION
21———NO ACTION TAKEN
25——UNABLE TO LOCATE RECORD ON FILEUNABLE TO LOCATE RECORD IN FILE
27——FILE UPDATE FIELD EDIT ERROR—
28———FILE UNAVAILABLE
30—DECLINE, MESSAGE FORMAT ERRORFORMAT ERRORFORMAT ERROR
39———NO CREDIT ACCOUNT
40——REQUESTED FUNCTION NOT SUPPORTED—
41—CAPTURE LOST CARDLOST CARDLOST CARD (PICK-UP)
43—CAPTURE STOLEN CARDSTOLEN CARDSTOLEN CARD (PICK-UP)
46—DENY ACCOUNT CLOSEDDENY ACCOUNT CLOSEDCLOSED ACCOUNT
51—DECLINE INSUFFICIENT FUNDSINSUFFICIENT FUNDS OR OVER CREDIT LIMITINSUFFICIENT FUNDS
52———NO CHECKING ACCOUNT
53———NO SAVINGS ACCOUNT
54—DECLINE EXPIRED CARDEXPIRED CARDEXPIRED CARD
55—DECLINED, INVALID PININVALID PININCORRECT PIN
57—DECLINE TRANSACTION DISALLOWED TO ISS/CRDHLDRTRANSACTION NOT PERMITTED TO ISS OR CARDHOLDER—
58—DECLINE TRANSACTION DISALLOWED TO ISS/CRDHLDRTRANSACTION NOT PERMITTED TO ACQ OR TERMINAL / TRANS NOT PERMITTED TO ACQUIRER OR TERMINALTRANSACTION NOT ALLOWED AT TERMINAL
59———DENY SUSPECTED FRAUD
61—DECLINE EXCEEDS WITHDRAWAL LIMITEXCEEDS WITHDRAWAL AMOUNT LIMITEXCEEDS WITHDRAWAL AMOUNT LIMIT
62—DECLINE RESTRICTED CARDRESTRICTED CARDRESTRICTED CARD
63—ERROR IN DECRYPTION OF PIN BLOCKSECURITY VIOLATIONSECURITY VIOLATION
64———TRANSACTION DOES NOT MEET AML REQUIREMENT
65—DECLINE EXCEEDS WITHDRAWAL COUNT LIMITSEXCEEDS WITHDRAWAL COUNT LIMITACTIVITY COUNT LIMIT EXCEEDED
68—RESPONSE RECEIVED LATE—RESPONSE RECEIVED LATE
70——CONTACT CARD ISSUERPIN DATA REQUIRED
71—MESSAGE OUT OF EXCEPTION CYCLE SEQUENCEPIN NOT CHANGEDMESSAGE OUT OF EXCEPTION CYCLE SEQUENCE
72—DENY CARD NOT YET EFFECTIVEDENY CARD NOT YET EFFECTIVEEXCEPTION CYCLE TIME EXPIRED
75—DECLINE ALLOWABLE NUMBER OF PIN TRIES EXCEEDEDALLOWABLE NUMBER OF PIN TRIES EXCEEDEDPIN TRIES EXCEEDED
76—DECLINE INVALID TO ACCOUNT SPECIFIEDINVALID OR NONEXISTENT TO ACCOUNT SPECIFIEDUNABLE TO LOCATE PREVIOUS MESSAGE
77—DECLINE INVALID FROM ACCOUNT SPECIFIEDINVALID OR NONEXISTENT FROM ACCOUNT SPECIFIED—
78—DECLINE INVALID ACCOUNT SPECIFIEDINVALID OR NONEXISTENT ACCOUNT SPECIFIEDBLOCKED, FIRST USED OR CARDHOLDER NOT ACTIVATED
79—LIFECYCLELIFECYCLEALREADY REVERSED (BY SWITCH)
80—DECLINE SYSTEM NOT AVAILABLEDUPLICATE ADD - ACTION NOT PERFORMEDREVERSAL RESPONSE TO DECLINED ORIGINAL
81——DOMESTIC DEBIT TRAN NOT ALLOWEDPIN CRYPTOGRAPHIC ERROR
82—POLICYPOLICYINCORRECT CVV
83—SECURITYSECURITY—
84——INVALID AUTHORIZATION LIFE CYCLE—
85—NA VALID FOR AVS ONLY REQUESTSNOT DECLINEDAPPROVED
86——PIN VALIDATION NOT POSSIBLEUNABLE TO VERIFY PIN
88——CRYPTOGRAPHIC FAILURE—
89——UNACCEPTABLE PIN - TRANSACTION DECLINED - RETRYINELIGIBLE TO RECEIVE FNCL INFO (810 RESPONSE)
91—DECLINE UNABLE TO ROUTE TRANSACTIONAUTHORIZATION SYSTEM OF ISSUER INOPERATIVEISSUER UNAVAILABLE OR SWITCH INOPERATIVE
92APPROVED (EXPRESS REWARDS PROGRAM)DECLINE UNABLE TO ROUTE TRANSACTIONUNABLE TO ROUTE TRANSACTIONDESTINATION CANNOT BE FOUND FOR ROUTING
93———VIOLATION OF LAW
94—DECLINE DUPLICATE TRANSMISSION DETECTEDDUPLICATE TRANSMISSION DETECTED—
96—DECLINE SYSTEM ERRORSYSTEM ERRORSYSTEM MALFUNCTION
100DENY———
101EXPIRED CARD / INVALID EXPIRATION DATE———
106EXCEEDED PIN ATTEMPTS———
107PLEASE CALL ISSUER———
109INVALID MERCHANT———
110INVALID AMOUNT———
111INVALID ACCOUNT———
115REQUESTED FUNCTION NOT SUPPORTED———
117INVALID PIN———
119CARD MEMBER NOT ENROLLED / NOT PERMITTED———
122INVALID CARD SECURITY CODE———
125INVALID EFFECTIVE DATE———
130DENY, STRONG CUSTOMER AUTHENTICATION REQUIRED———
181FORMAT ERROR———
183INVALID CURRENCY CODE———
187DENY - NEW CARD ISSUED———
188DENY - ACCOUNT CANCELED———
189DENY - CANCELED OR CLOSED MERCHANT———
194DENY, INVALID REGION CODE———
200DENY - PICK UP CARD———
400REVERSAL ACCEPTED———
800NW MANAGEMENT APPROVED———
900ACCEPTED - ATC SYNCHRONIZATION———
909SYSTEM MALFUNCTION———
911ISSUER TIMEOUT———
912ISSUER NOT AVAILABLE———
1A———ADDITIONAL CUSTOMER AUTHENTICATION REQUIRED
5C———TRANSACTION NOT SUPPORTED / BLOCKED BY ISSUER
6P———VERIFICATION DATA FAILED
9G———BLOCKED BY CARDHOLDER / CONTACT CARDHOLDER
B2———SURCHARGE AMT NOT SUPPORTED BY DEBIT NETWORK ISS
N3———CASH SERVICE NOT AVAILABLE
N4———CASH REQUEST EXCEEDS ISSUER LIMIT
N7———CVV2 FAILURE
N8———TRANSACTION AMT EXCEED PREAUTHORIZED APPR AMOUNT
P0———APPROVED - PVID CODE MISSING OR HAS EXPIRED
P1———DECLINED - PVID CODE MISSING OR HAS EXPIRED
P5———DENIED PIN UNBLOCK
P6———DENIED PIN CHANGE
Q1———CARD AUTHENTICATION FAILED
R0———DENY SPECIFIC STOP PAYMENT
R1———DENY ALL STOP PAYMENTS
Z5———VALID ACCOUNT BUT AMOUNT NOT SUPPORTED

Error Codes

Getnet returns these codes with a 400 Bad Request HTTP status when a transaction fails validation or violates a business rule before reaching the card network.

Error CodeDescriptionMeaning
1The seller informed was not foundThe seller does not exist or is not integrated with the platform.
2Seller not activeThe seller exists but is not active.
3Terminal not found for this operationThe terminal code does not exist or is not integrated with the platform.
4Terminal not activeThe terminal exists but is not active.
5Product not found for requested operationThe product does not exist or is not integrated with the platform.
6Acquirer product not activeThe product exists but is not active.
7Card not accepted for this operationThe BIN is unsupported or the BIN table is outdated.
8Unable to refund the transaction. It can only be canceled.The transaction supports cancellation only, not refunds.
9The date limit to refund the transaction was expiredThe refund window has expired.
10Denied, it’s not possible to refund a {transaction_status} transactionThe transaction status does not permit refunds.
11The acquirer informed was not foundThe acquirer does not exist or is not integrated with the platform.
12Operation not available for cardThe requested operation does not match the BIN lookup result.
13Swiped accepted only with sign authorizationMagnetic operations support offline PIN validation only.
14Transaction not foundNo transaction matches the provided parameters.
15Transaction not found with payment_id: {payment_id}No transaction matches the provided payment_id.
16Denied. It’s not possible to cancel a {transaction_status} transactionThe transaction status does not permit cancellation.
17It’s not possible to cancel. More than one transaction has been foundMore than one transaction matches the provided parameters.
18The date limit to cancel the transaction was expiredThe cancellation window has expired.
19The date limit to undo the transaction was expiredThe undo window has expired.
20Acquirer code not informedThe acquirer code field is empty.
21The capture time limit is overThe capture window has expired.
22Denied. It’s not possible to capture a {status} transactionThe transaction status does not permit capture.
23The country_code not foundcountry_code is not configured for the seller or acquirer.
24The AID not foundThe AID is not in the registered AID list.
25Denied. It’s not possible to reverse a transaction that has already been printedTransactions with a printed receipt do not support reversal.
26Denied. It’s not possible to reverse a {status} transactionThe transaction status does not permit reversal.
27Seller with seller_code {sellerCode} can’t be foundNo seller matches the provided seller_code.
28Seller with seller_id {sellerId} can’t be foundNo seller matches the provided seller_id.
29Merchant with merchant_id {merchantId} can’t be foundNo merchant matches the provided merchant_id.
30Terminal {terminalCode} not found for this operationNo terminal matches the provided terminal code.
31Cannot find tokenized dataNo tokenized data found for this reversal or cancellation.
32Card not foundThe system cannot extract the card number from the provided card data.
33Empty timezone infoThe system cannot extract timezone information from the transaction.
34Denied. It’s not possible to do an installment transaction with the operation {operation}Installment transactions require the credit operation.
35CVM is required for entry_mode CHIPCVM is required when the entry mode is CHIP.
36CVM mode not availableThe CVM value is not recognized.
37Service Code is required when CVM not present and entry_mode is CHIP_CONTACTLESSService Code is required when CVM is absent and the entry mode is CHIP_CONTACTLESS.
38Service Code is required for entry_mode MAGNETICService Code is required when the entry mode is MAGNETIC.
39Service code method not availableThe Service Code value is not recognized.
40Denied. It’s not possible to reverse the transactionPayment data without a receipt must contain exactly one record.
41Denied. Card not accepted for non-productive environmentThe card is not on the allowed list for non-production environments.
42Denied. Brand {brand} not supported for authentication flow3DS authentication supports Visa and Mastercard only.
43Denied. Transaction already been captured with a different amountThe capture amount does not match the originally authorized amount.
44Denied. Operation {operation} not available for brand {brand}The card brand does not support this operation.
45Transaction already exists with provided keysA transaction with the same keys already exists.
46No valid transactions to captureNo valid transaction is available to capture.
47Confirmation denied. The maximum amount of {amount} exceededThe confirmation amount exceeds the maximum allowed.
48Confirmation denied. Transaction already capturedThe transaction was already captured.
49Denied. It’s not possible to re-authorize a {status} transactionThe transaction status does not permit re-authorization.
50Deny. Pre-authorization is not allowed for {brand} brandThe card brand does not support pre-authorization.
51Deny. Installments are not allowed for {brand} brandThe card brand does not support installments.
52Denied. Skip payment is not allowed for American Express brandAmerican Express does not support skip payment installments.
53Denied. Product not found with {installment.number} installmentsNo product is configured for the specified installment count.
54Installments product not foundNo installment product is configured.
55The transaction_channel_type is invalid or not foundThe transaction_channel_type value is invalid or not configured.
56This seller does not have a {brand} affiliationThe seller does not have a {brand} affiliation registered.
57Merchant category with code {code} can’t be foundNo merchant category matches the provided merchant_category_code.
58Card data does not match the original transaction dataThe card number does not match the BIN or transaction summary.
59Card info can’t be foundNo card information matches the provided data.
60It’s not possible to do a reversal. More than one transaction has been foundMore than one transaction matches the reversal parameters.
61Switch code not found for {brand} at acquirer with code {acquirer_code}No switch code is configured for the brand and acquirer combination.
62Denied, duplicated sellerMore than one seller record matches the provided data.
63Deny. Manual transaction not acceptedManual card entry is not permitted in card-present transactions.
64PIN online is not allowed for {brand}The card brand does not support online PIN.
65Installment is not available for this acquirer switchThe acquirer switch does not support installments.
66Denied, the amount is not the same as the original amountThe amount does not match the original transaction amount.
67The transaction amount of QPS must be lower than or equalThe transaction amount exceeds the QPS threshold.
68Denied. Transaction already refundedThe transaction was already refunded.
69Denied. The amount must be less than or equal to the original amountThe refund amount exceeds the original authorized amount.
70Denied. Operation {operation} not available for {situation.status} transactionThe transaction status does not permit this operation.
71Denied. The last 4 digits of the card are incorrectThe last 4 digits of the card do not match.
72Denied. The tip percentage must be less than or equal to 20% of the total amountThe tip percentage exceeds 20% of the total amount.
73Denied, card number does not agree with mod10 algorithmThe card number fails the Luhn (mod10) check.
74Denied. Special Payment {specialPaymentIndicator} is not allowed for {brand} brandThe card brand does not support this special payment indicator.
75Denied. Tip is not allowed for {brand} brandThe card brand does not support tips.
76Denied. Dynamic currency conversion is not allowed for {brand} brandThe card brand does not support dynamic currency conversion.
77Denied. Dynamic currency conversion is not allowed for this sellerThe seller is not configured for dynamic currency conversion.
78Denied. Recurring is not allowed for {brand} brandThe card brand does not support recurring transactions.
79Denied. Brand {brand} not supported for wallet flowWallet flow supports Visa and Mastercard only.
80Denied. This brand {brand} does not accept zero amountThe card brand does not support zero-amount authorizations.
81Denied. An error occurred when tokenizing dataAn error occurred during tokenization.
82The authorization was not routed to the scheme. It is not necessary to send a {operation} request.The original transaction was not routed to the scheme. No follow-up operation is needed.
83The selected_account is only valid for Maestro transactionsselected_account is valid for Maestro transactions only.
84The reference_code has already been used. Send a different reference_code.The reference_code is already in use. Provide a different value.
85Denied. The amount must be greater than {minimumAmount}The refund amount is below the minimum allowed.
86Denied. Card verification is not allowed for {brand} brandThe card brand does not support card verification.
87Denied. Card verification is not allowed for this sellerThe seller is not configured for card verification.
88Denied. Insufficient balance for this transactionThe available balance is insufficient for this refund.
89Denied. Expire operation is not allowed for {brand} brandThe card brand does not support the expire operation.
90Denied. The date limit to capture was not expiredThe capture date limit has not yet passed.
91Denied. It’s not possible to expire a {transactionStatus} transactionThe transaction status does not permit expiry.
92It’s not possible to {operation} with different terminal.The reversal must use the same terminal as the original transaction.
93Transaction Not Allowed. Contact your card issuer for more information.The transaction was denied by fraud analysis or for an undisclosed reason.
94Denied. Airline is not allowed for {brand} brandThe card brand does not support airline transactions.
95Affiliation of transaction must be either amex_optblue or amex_switchThe affiliation must be either amex_optblue or amex_switch.
96The transaction amount is lower than the minimum value.The transaction amount is below the acquirer’s configured minimum.
97Taxes calculation failedTax calculation failed.
98Cents not accepted for CLP currencyCLP currency does not accept cent amounts.
99Report days more than allowedThe requested report period exceeds the maximum allowed.
100It’s not possible to refund while another transaction is in progressA refund is already in progress for this transaction.
101Denied. Transaction not allowedThe transaction is not permitted. Contact the issuer for details.
103Denied. The dynamic_mcc is not allowedThe acquirer does not permit dynamic_mcc. The value cannot be overridden.
104Denied. It’s not possible to refund. More than one transaction has been foundMore than one transaction matches the refund parameters.
105Denied. The refund amount is over the maximum refund amount: {maximumAmount}The refund amount exceeds the maximum of {maximumAmount}.
106The sum of tip value and tip partial amount must equal the amountThe tip value and tip partial amount must equal the total amount.
107Denied, {voucher_type} exceeded date limit of {days} daysThe voucher has exceeded its allowed time limit.
108Denied, {voucherType} is not allowed for {brand} brandThe card brand does not support this voucher type.
109Denied. Refund is impossible yet because the migration is not completedThe seller migration is not complete. Refunds are unavailable until migration finishes.
110According to Mastercard’s rule, one of these fields is required: security code, 3DS authentication, or tokenization data.Per Mastercard’s rules, provide at least one of: security code, 3DS authentication, or tokenization data.
111Currency must be the same used at the {transactionType} transactionThe currency must match the original transaction currency.
112Denied, adjustments are not allowed by {brand} brand.The card brand does not allow adjustments.
113Denied, adjustments maximum number reached.The transaction has reached the maximum number of adjustments.
114Denied, amount exceeds the maximum adjustment limit.The adjusted amount exceeds the maximum allowed increase.
115Denied, amount exceeds the maximum capture limit.The capture amount exceeds the maximum allowed increase.
116Denied, amount does not reach the minimum capture limit.The capture amount falls below the minimum allowed.
117Denied, brand {brand} does not allow lowering the amount.The card brand does not allow reducing the authorized amount.
118Denied, brand {brand} does not allow pre_authorization for {operation} operation.The card brand does not allow pre-authorization for this operation.
119Denied, brand {brand} does not allow pre_authorization for prepaid cards.The card brand does not allow pre-authorization for prepaid cards.
120Denied, amount must be different from the last authorized.The adjustment amount must differ from the last authorized amount.
121Adjustment denied, pre-authorized transaction does not have dynamic_currency_conversion.DCC adjustments require the original transaction to have included DCC.
122Denied. Unable to decrypt tokenized PAN.The HSM could not decrypt the tokenized PAN.
123Denied, adjustments are allowed only for pre-authorized transactions.Adjustments are only allowed for pre-authorized transactions.
124Denied. It’s not possible to {EnumPaymentOperation} a {transactionType} transaction.The {EnumPaymentOperation} operation is not permitted for {transactionType} transactions.
125Denied. It is not possible to adjust. This transaction is currently expired.The transaction has expired and cannot be adjusted.
126Card not eligible for DCC transactionsThe card BIN is not eligible for DCC.