Transaction Status and Response Codes

Each payment has one or more associated transactions. The following documentation covers transaction types, status codes, and descriptions after an HTTP 200 status is obtained and a transaction is processed.

Workflow

Types of transactions

TypeDescription
PURCHASEA direct purchase transaction.
AUTHORIZETransaction associated with authorization. Mainly for card payments.
CAPTUREA capture of a previously authorized transaction.
REFUNDA refund of a previously approved transaction.
CANCELA cancelation of a previously pending transaction.
VERIFYTransaction associated with a credit card verification.
CHARGEBACKTransaction associated with a chargeback.
THREE_D_SECUREA 3DS verification transaction for an initial purchase.
FRAUD_SCREENINGFraud screening is associated with fraud verification.

Transaction codes

With every transaction, you´ll receive a response_code detailing more info about it. The details related to each status are presented below. Use the following buttons to navigate to the desired content.

Succeeded status

SUCCEEDED status details
response_code Description Hard/Soft decline ISO 8583 code
SUCCEEDED Transaction successful N/A 0,8,10,11,16,32
FRAUD_VERIFIED Transaction verified by fraud provider N/A -
SUCCEEDED_THREE_D_SECURE 3DS validation successful N/A -

Won status

WON status details
response_code Description Hard/Soft decline ISO 8583 code
REVIEW_WON Acquirer rejected the chargeback N/A -

Created status

CREATED status details
response_code Description Hard/Soft decline ISO 8583 code
ACTION_REQUIRED Chargeback or Inquiry received. Decision or documentation must be provided N/A -
SUCCEEDED Transaction created successfully N/A -

Pending status

PENDING status details
response_code Description Hard/Soft decline ISO 8583 code
CHALLENGE_REQUIRED Transaction waiting for the challenge completion N/A -
IN_REVIEW Chargeback documentation was sent to the provider and is being analyzed N/A -
PENDING_FRAUD_REVIEW Transaction is being analyzed by fraud provider N/A -
PENDING_PROVIDER_CONFIRMATION Transaction waiting confirmation N/A -
PENDING_REVIEW Transaction waiting fraud review confirmation N/A -

Declined status

DECLINED status details
response_code Description Hard/Soft decline ISO 8583 code
ACCOUNT_STATUSContact your fraud provider to verify your account status.N/A-
ACQUIRE_CONTINGENCYAcquire service unavailableSOFT22, 80, 90, 91, 92, 96
AUTHENTICATION_ATTEMPTAuthentication attempt without completionN/A-
AUTHENTICATION_FAILED_THREE_D_SECURE3D validation failedN/A-
BAD_FILLED_INFOCard does not match the parameters from the issuerHARD30,89
BANK_NOT_SUPPORTEDBank not supported by switchSOFT31
CALL_FOR_AUTHORIZECard acceptor call acquirer's security departmentSOFT66
CANCELLED_BY_USERCancelled by userSOFT17
COUNTRY_NOT_SUPPORTEDThis transaction cannot be processed due to an unsupported countryHARD-
CURRENCY_NOT_ALLOWEDCurrency not allowed HARD-
DECLINED_BY_BANKRejected by the bank. Refer to card issuerSOFT-
DECLINED_BY_PROVIDERRejected by the provider. Refer to the provider_dataSOFT-
DISABLEDRestricted cardSOFT-
DO_NOT_HONORDo not honorSOFT5
DUPLICATED_TRANSACTIONDuplicate transmission of the transactionSOFT26,94
EXPIREDExpired alternative payment methodSOFT
EXPIRED_CARDExpired cardHARD33,54
FIRST_USEBlocked first useSOFT78
FRAUD_VALIDATIONSecurity violationSOFT34, 59, 63, 64
FRAUD_VERIFICATION_DECLINED---
INSUFFICIENT_FUNDSNot sufficient funds SOFT51
INVALID_AMOUNTInvalid amountSOFT13,64
INVALID_CARD_DATACard does not match the parameters from the issuer.HARD56
INVALID_CARD_NUMBERCard does not match the parameters from the issuer.HARD14
INVALID_APITrying to verify the payment with an unauthorized IP addressHARD-
INVALID_API_VERSIONInvalid API versionHARD-
INVALID_CREDENTIALSFraud provider invalid credentials set in Yuno.HARD-
INVALID_ISSUERInvalid issuerSOFT15
INVALID_MERCHANTInvalid merchant or service providerSOFT3
INVALID_PARAMETERSInvalid parametersHARD-
INVALID_SECURITY_CODEInvalid card's security codeHARD56,82
INVALID_STATUSInvalid statusSOFT-
INVALID_RESPONSE_FORMATThe response body returned by the provider has an invalid formatSOFT-
INVALID_TRANSACTIONThe transaction being attempted is invalidHARD12,23
ISSUER_VIOLATIONThe issuing bank rejected the transaction due to some violation related to the account.SOFT93
MISSING_PARAMETERSMissing parametersHARD-
NO_RETRY_LIFE_CYCLENo retry life cycleHARD79
NO_RETRY_POLICYNo retry policyHARD82
NO_RETRY_SECURITYNo retry securityHARD83
RETRY_AFTER_1_HRetry after 1 hoursHARD
RETRY_AFTER_24_HRetry after 24 hoursHARD
RETRY_AFTER_2_DRetry after 2 daysHARD
RETRY_AFTER_4_DRetry after 4 daysHARD
RETRY_AFTER_6_DRetry after 6 daysHARD
RETRY_AFTER_8_DRetry after 8 daysHARD
RETRY_AFTER_10_DRetry after 10 daysHARD
REJECTED_THREE_D_SECURE_REQUIRED3DS validation rejectionSOFT-
REPORTED_LOSTLost cardHARD41
REPORTED_STOLENStolen card, pick-upHARD43
REQUESTS_EXCEEDEDRequests limit for the provider account reached.SOFT-
RESTRICTED_BY_BANKRejected by the bank. Refer to card issuer's special conditionsSOFT62
TERMINAL_ERRORYour merchant account is not properly configured for the transactionSOFT58
THREE_D_SECURE_REQUIREDAntifraud provider requires a 3DS challenge for further validation.SOFT
TRANSACTION_NOT_FOUNDTransaction not foundHARD25
UNAVAILABLE_PAYMENT_METHODRequested function not supportedHARD-
UNSUPPORTED_OPERATIONRequested function not supportedHARD40
UNKNOWN_ERRORUnknown errorSOFT-
USER_RESTRICTIONTransaction not permitted for cardholderHARD57

Rejected status

REJECTED status details
response_code Description Hard/Soft decline ISO 8583 code
COUNTRY_NOT_SUPPORTED - HARD -
CURRENCY_NOT_ALLOWED - HARD -
INVALID_PARAMETERS - HARD -
INVALID_REQUEST - HARD -
INTERNAL_ERROR - HARD -
MISSING_PARAMETERS - HARD -

Error status

ERROR status details
response_code Description Hard/Soft decline ISO 8583 code
ERROR Unknown internal error SOFT -
PROVIDER_ERROR Error. An unknown error occurred during the authorization SOFT 6
PROVIDER_INTERNAL_ERROR Internal error SOFT 98
PROVIDER_INVALID_CREDENTIALS Invalid credentials HARD -
PROVIDER_INVALID_REQUEST Invalid request HARD -
PROVIDER_TIMEOUT Response received too late SOFT 68
PROVIDER_UNKNOWN_ERROR Unknown error SOFT -
OPERATION_NOT_SUPPORTED Provider does not support this operation HARD -
TO_REVERSE The transaction will be reversed HARD -
PROVIDER_INVALID_RESPONSE Invalid response HARD 20
PROVIDER_INVALID_API_VERSION Invalid API version HARD -

Expired status

EXPIRED status details
response_code Description Hard/Soft decline ISO 8583 code
EXPIRED_BY_PROVIDER - N/A -

Lost status

LOST status details
response_code Description Hard/Soft decline ISO 8583 code
CLOSED - N/A -
EXPIRED - N/A -
PARTIALLY_CHARGEBACKED - N/A -
REVIEW_LOST The Chargeback dispute was lost N/A -

Chargebacks specific response_codes

For more details, please refer to the reason codes page in the Chargeback guides section.

CREATED status details
response_code response_message Category Description
EMV_LIABILITY_SHIFT_COUNTERFEIT EMV Liability Shift Counterfeit Fraud Fraud The cardholder is claiming that they did not authorize or participate in a transaction that you processed.
EMV_LIABILITY_SHIFT_NOT_COUNTERFEIT EMV Liability Shift Non-Counterfeit Fraud Fraud The cardholder is claiming that they did not authorize or participate in a transaction that you processed.
CARD_PRESENT_FRAUD Other Fraud – Card-Present Environment Fraud The cardholder is claiming that they did not authorize or participate in a key-entered or unattended transaction conducted in a card-present environment.
NON_CARD_PRESENT_FRAUD Other Fraud – Card-Absent Environment Fraud The cardholder did not authorize or participate in a transaction conducted in a card-not-present environment, such as internet, mail-order, phone-order, and others.
SCHEME_MONITORING_PROGRAM Other Fraud - Scheme Monitoring Program Fraud Scheme Fraud Monitoring program
NO_AUTHORIZATION No Authorization Authorization Correct and valid authorization was not obtained by the merchant.
DECLINED_AUTHORIZATION Declined Authorization Authorization Authorization request received a Decline response and the merchant completed the transaction.
LATE_PRESENTMENT Late Presentment Processing Errors The transaction was not sent to Visa within the timeframe required.
INCORRECT_TRANSACTION_CODE Incorrect Transaction Code Processing Errors The cardholder is claiming that the converted amount of charge on an international transaction is incorrect.
INCORRECT_CURRENCY Incorrect Currency Processing Errors The merchant made one or more errors related to the transaction currency
INCORRECT_ACCOUNT_NUMBER Incorrect Account Number Processing Errors The account number in the authorization does not match the account number used in the transaction.
INCORRECT_AMOUNT Incorrect Amount Processing Errors The cardholder is claiming that the amount they agreed to pay differs from the amount charged.
DUPLICATE_PROCESSING Duplicate Processing/Paid by Other Means Processing Errors A single transaction was processed two or more times.
INVALID_DATA Invalid Data Processing Errors The authorization was obtained using invalid or incorrect data.
PRODUCT_OR_SERVICE_NOT_RECEIVED Merchandise/Services Not Received Customer Disputes The cardholder is claiming that merchandise or services that they ordered were not received.
CANCELED_RECURRING_TRANSACTION Cancelled Recurring Transaction Customer Disputes A recurring transaction was processed after it was cancelled.
PRODUCT_OR_SERVICE_ISSUE Not as Described or Defective Merchandise/Services Customer Disputes The cardholder is claiming the goods were not as described.
COUNTERFEIT_MERCHANDISE Counterfeit Merchandise Customer Disputes The merchandise was identified as counterfeit.
MISREPRESENTATION Misrepresentation Customer Disputes The cardholder’s bank received a notice from the cardholder is claiming misrepresented terms of sale.
CREDIT_NOT_PROCESSED Credit Not Processed Customer Disputes The cardholder’s bank received a notice from the cardholder claiming that they received authorization, credit or voided transaction receipt that has not been processed.
PRODUCT_OR_SERVICE_CANCELED Cancelled Merchandise/Services Customer Disputes The cardholder’s bank received a notice from the cardholder stating that they returned merchandise or cancelled services, but the credit has not appeared on the cardholder’s Visa statement.
ORIGINAL_TRANSACTION_NOT_ACCEPTED Original Credit Transaction Not Accepted Customer Disputes The original credit was not accepted.
CASH_TRANSACTION_VALUE Non-Receipt of Cash or Load Transaction Value Customer Disputes Cardholder did not receive the full cash withdrawal at an ATM.
CUSTOMER_AGREEMENT Proof of customer transaction or agreement required. Customer Disputes The issuer asks the merchant for a copy of the receipt signed by the cardholder or any other documentation that verifies the customers agreement for the purchase. Usually to verify a card-present transaction the cardholder disputes or doesn’t recognize.