All providers
RETURN CODE REFERENCE

Cielo error codes

All 142 codes Cielo documents, with what each one means and what to do about it.

00Transaction authorized successfullyApprovedApproved4Transaction authorized (ready to be captured)ApprovedApproved6Transaction capturedApprovedApproved002Invalid credentialsInvalid credentialsIntegration issue003Transaction does not existTransaction not foundIntegration issue01Mastercard: card number does not belong to the issuer / invalid card number.Invalid card numberHard decline02Not authorized: transaction referred by the issuing bank (suspected fraud). Cardholder should contact the issuer.Refer to card issuerSoft decline03Invalid merchantMerchant account issueIntegration issue04Varies by brand. Elo: redo the transaction (issuer requests a retry). Visa/Mastercard: pick up card; Mastercard also uses it for confirmed fraud.Declined by the issuerSoft decline05GenericDeclined by the issuerSoft decline06Varies by brand. Elo: consult the acquirer. Visa: card error, check the card data.Declined by the issuerSoft decline07Confirmed fraudSuspected fraudHard decline09Transaction partially cancelled successfullyApprovedApproved11Transaction authorized successfully for a card issued abroad.ApprovedApproved12Varies by brand. Elo: card error. Visa: message format error. Mastercard: invalid installment amount.Declined by the issuerSoft decline13Invalid transaction amountInvalid amountIntegration issue14Card number does not belong to the issuer / invalid card number (Visa, Mastercard).Invalid card numberHard decline15Issuer not found - incorrect BINIssuer not recognizedHard decline19Problem at the acquirerProvider errorSoft decline21Cancellation not performed: transaction not found.Transaction not foundIntegration issue22Invalid installment plan: invalid number of installments.Invalid transactionIntegration issue23Invalid installment amountInvalid amountIntegration issue24Invalid number of installmentsInvalid transactionIntegration issue30Message format error (Elo, Mastercard). Mastercard also uses it for a problem at the acquirer.Invalid transactionIntegration issue38Elo: PIN attempts exceeded (purchases). Cardholder should contact the card issuer.Not permitted for this cardholderSoft decline39Incorrect function (credit)Not supportedIntegration issue41Lost cardCard reported lostHard decline43Stolen cardCard reported stolenHard decline46Account closed (Elo, Visa). Visa also uses it for deactivated tokens.Card blocked or closedHard decline51Insufficient balance/limitInsufficient fundsSoft decline52Incorrect function (debit)Not supportedIntegration issue53Incorrect function (debit)Not supportedIntegration issue54Expired card / invalid expiration dateExpired cardHard decline55Invalid PIN. Mastercard also uses it when a new PIN is not accepted.Card details don't matchSoft decline56Elo: card number does not belong to the issuer / invalid card number.Invalid card numberHard decline57Transaction not permitted for the card. Elo and Mastercard also use it for other causes (e.g. terminal capability, confirmed fraud, temporary block).Not permitted for this cardholderSoft decline58Varies by brand. Elo: invalid merchant. Visa/Mastercard: transaction not permitted, terminal capability.Declined by the issuerSoft decline59Suspected fraud / travel noticeSuspected fraudHard decline5CElo: transaction not supported or blocked by the issuer. Cielo notes this code only takes effect on 23 Oct 2026.Restricted by the bankSoft decline60Not authorized. Try again; if it persists the cardholder should contact the issuing bank.Declined by the issuerSoft decline61Amount exceeded / withdrawalNot permitted for this cardholderSoft decline62Temporary block (e.g. default) or domestic card used internationally. Mastercard also uses it for legal-violation declines and closed accounts.Restricted by the bankSoft decline63Security violation (invalid or not present) - check card data. Mastercard also uses it for suspected fraud / travel notice.Suspected fraudHard decline64Varies by brand. Elo: invalid minimum transaction amount. Visa: non-compliance with anti-money-laundering laws.Declined by the issuerSoft decline65Number of withdrawals exceededNot permitted for this cardholderSoft decline66Elo: non-compliance with anti-money-laundering laws.Blocked for complianceHard decline67Not authorized: card blocked for purchases today, possibly after too many invalid attempts. It unblocks automatically at midnight.Card blocked or closedHard decline70Not authorized: limit exceeded / no balance.Insufficient fundsSoft decline72Cancellation not performed: insufficient balance available for cancellation.Invalid transactionIntegration issue73Withdrawal not availableNot supportedIntegration issue74Expired PIN / PIN encryption errorCard details don't matchSoft decline75PIN attempts exceeded. Cardholder should contact the card issuer.Not permitted for this cardholderSoft decline76Varies by brand. Elo: destination account invalid or non-existent. Visa: invalid reversal.Invalid transactionIntegration issue77Elo: source account invalid or non-existent.Invalid transactionIntegration issue78New card not yet unblocked, or card blocked by the cardholder (e.g. in the app / NFC). Cardholder should unblock the card.Card blocked or closedHard decline79Varies by brand. Elo: security/fraud. Mastercard: transaction not permitted for the card - follow the Merchant Advice Code (MAC).Declined by the issuerSoft decline80Varies. Elo: invalid reversal. Otherwise: not authorized, transaction date or first payment date is invalid.Invalid transactionIntegration issue81Varies by brand. Elo: function blocked for the cardholder. Visa: expired PIN / PIN encryption error.Declined by the issuerSoft decline82Varies by brand. Elo/Visa: invalid card (cryptogram). Mastercard: not authorized due to issuer rules, call the issuer (follow the MAC).Declined by the issuerSoft decline83Varies by brand. Elo: expired PIN / PIN encryption error. Visa: fraud/security. Mastercard: suspected fraud (follow the MAC).Declined by the issuerSoft decline85Transaction not permitted: operation failure (processing error). Have the cardholder re-enter the card data.Provider errorSoft decline86Invalid PINCard details don't matchSoft decline88Mastercard: expired PIN / PIN encryption error, or invalid card (cryptogram).Card details don't matchSoft decline89Transaction error. Cardholder should try again and contact the issuing bank if it persists.Declined by the issuerSoft decline90Transaction not permitted: operation failure (processing error). Have the cardholder re-enter the card data.Provider errorSoft decline91Issuer offlineIssuer or acquirer unavailableSoft decline92Not located by the routerIssuer not recognizedHard decline93Transaction denied for violation of lawBlocked for complianceHard decline94Duplicate tracing data value. For Mastercard, Cielo notes this code only takes effect on 10 Nov 2026.Duplicate transactionIntegration issue96System failureProvider errorSoft decline97Amount not permitted for this transactionInvalid amountIntegration issue98System/communication unavailable: no communication with the issuer's system.Issuer or acquirer unavailableSoft decline475Cancellation timeoutProvider timed outSoft decline999System/communication unavailable: no communication with the issuer's system. Try again later.Issuer or acquirer unavailableSoft decline6PVisa: ID validation failure. Also returned as not authorized, invalid data - cardholder should review the data and retry.Card details don't matchSoft declineAATimed out communicating with the issuing bank. Cardholder should try again.Provider timed outSoft declineABIncorrect function (debit)Not supportedIntegration issueACIncorrect function (credit)Not supportedIntegration issueAFTransaction not permitted: operation failure (processing error). Have the cardholder re-enter the card data.Provider errorSoft declineAGTransaction not permitted: operation failure (processing error). Have the cardholder re-enter the card data.Provider errorSoft declineAHNot permitted: credit card being used as debit. Cardholder should select the credit option.Not supportedIntegration issueAINot authorized: authentication was not performed (the cardholder did not complete authentication).Authentication failedSoft declineAJNot permitted: credit or debit used in an operation that only allows Private Label.Not supportedIntegration issueAVNot authorized: invalid data. Transaction data validation failed; cardholder should review the data and retry.Card details don't matchSoft declineBDTransaction not permitted: operation failure (processing error). Have the cardholder re-enter the card data.Provider errorSoft declineBLNot authorized: daily limit exceeded.Not permitted for this cardholderSoft declineBMNot authorized: invalid card. The card may be blocked at the issuer or the data may be incorrect.Card details don't matchSoft declineBNNot authorized: card or account blocked.Card blocked or closedHard declineBOTransaction not permitted: operation failure (processing error). Re-enter the card data; if it persists, contact the issuing bank.Provider errorSoft declineBPNot authorized: checking account does not exist (error related to the cardholder's card or account).Card details don't matchSoft declineBP171Rejected for fraud risk (Velocity rules).Suspected fraudHard declineBP176Transaction not permitted. The partner should check that the integration process was completed successfully.Merchant account issueIntegration issueBP900Operation failure (while sending the request).Provider errorSoft declineBP901Operation failure (related to an authorization failure).Provider errorSoft declineBP902Wait for the response to the previous operation (related to a capture failure).Provider errorSoft declineBP903Cancellation failureProvider errorSoft declineBP904Query failureProvider errorSoft declineBRNot authorized: account closed.Card blocked or closedHard declineC1Not permitted: the card cannot process debit transactions. Change the payment type or card.Not supportedIntegration issueC2Transaction not permitted: incorrect data. Review the data entered on the payment screen.Card details don't matchSoft declineC3Transaction not permitted: invalid period for this type of transaction.Invalid transactionIntegration issueCFNot authorized: data validation failure. Cardholder should contact the issuing bank.Card details don't matchSoft declineCGNot authorized: data validation failure. Cardholder should contact the issuing bank.Card details don't matchSoft declineDFNot permitted: card failure or invalid card. Have the cardholder re-enter the card data.Card details don't matchSoft declineDMNot authorized: limit exceeded / no balance.Insufficient fundsSoft declineDQNot authorized: data validation failure. Cardholder should contact the issuing bank.Card details don't matchSoft declineDSTransaction not permitted for the cardNot permitted for this cardholderSoft declineEBNumber of installments greater than allowed. Check with Cielo that installments are enabled for the merchant.Invalid transactionIntegration issueEENot permitted: installment amount below the minimum allowed (installments under R$ 5.00 are not permitted).Invalid amountIntegration issueEKTransaction not permitted for the cardNot permitted for this cardholderSoft declineFCNot authorized: call the issuer.Call for authorizationSoft declineFENot authorized: transaction date or first payment date is invalid.Invalid transactionIntegration issueFFCancellation OK: cancellation authorized successfully (returned for cancellations, not authorizations).ApprovedApprovedFGNot authorized: cardholder should call the AmEx service centre.Call for authorizationSoft declineFMUse the chipNot supportedIntegration issueGAAwait contact: not authorized, referred preventively by Lynx Online.Declined by the providerSoft declineGDTransaction not permitted. Contact Cielo.Declined by the providerSoft declineGFTransaction denied: check that the IP address sent is allowed to process the transaction.Declined by the providerSoft declineGKTransaction denied: temporary block due to a brute-force attack.Suspected fraudHard declineGTTransaction denied: brute-force attack.Suspected fraudHard declineHJTransaction not permitted: invalid (Coban) operation code.Invalid request dataIntegration issueIATransaction not permitted: invalid (Coban) operation indicator.Invalid request dataIntegration issueKANot permitted: data validation failure. Review the data; if it persists check the store-to-Cielo communication.Invalid request dataIntegration issueKBNot permitted: incorrect option selected. Review the data; if it persists check the store-to-Cielo communication.Invalid request dataIntegration issueKENot authorized: data validation failure - the selected option is not enabled.Not supportedIntegration issueN0Force STIPDeclined by the issuerSoft declineN3Withdrawal not availableNot supportedIntegration issueN4Amount exceeded / withdrawalNot permitted for this cardholderSoft declineN7Visa: security violation (invalid or not present) - check card data; also used for a dynamic key change error.Suspected fraudHard declineN8Difference from the pre-authorization amountInvalid amountIntegration issueNRTransaction not permitted. Retry only after 30 days.Declined by the issuerSoft declineP5PIN change / unblockingCard details don't matchSoft declineP6New PIN not acceptedCard details don't matchSoft declineB1Surcharge not supportedNot supportedIntegration issueB2Surcharge not supported by the debit networkNot supportedIntegration issueR0Recurring payment suspended for one serviceDeclined by the issuerSoft declineR1Recurring payment suspended for all servicesDeclined by the issuerSoft declineR2Transaction not qualified for Visa PINNot supportedIntegration issueR3All authorization orders suspendedDeclined by the issuerSoft declineRPTransaction not permitted. Retry only after 72 hours.Declined by the issuerSoft declineSCTransaction not permitted: recurring payment, service cancelled. Do not retry.Declined by the issuerSoft declineU3Not permitted: data validation failure. Review the data; if it persists check the store-to-Cielo communication.Invalid request dataIntegration issue

Source: Cielo docs — Códigos de Retorno padrão ABECS (API E-commerce Cielo) · Cielo docs — Códigos de retorno de negócio da API (Return, Provider e Reason)

Reference only. Codes and descriptions come from each provider's public documentation. The Yuno response code is a reference mapping and does not guarantee how a specific transaction is processed.