Transactions

Overview

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 associated to the 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.

Succeeded status

SUCCEEDED status details
response_code Description Hard/Soft decline ISO 8583 code
SUCCEEDED Transaction successful N/A -
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_STATUS Contact your fraud provider to verify your account status. N/A -
ACQUIRE_CONTINGENCY Acquire service unavailable SOFT 22, 80, 90, 91, 92, 96
AUTHENTICATION_FAILED_THREE_D_SECURE 3D validation failed N/A -
AUTHORIZATION_REQUIRED Performing this action on this resource requires authorization SOFT -
BAD_FILLED_INFO Card does not match the parameters from the issuer. SOFT 30, 89
BANK_NOT_SUPPORTED Bank not supported by switch SOFT 31
CALL_FOR_AUTHORIZE Card acceptor call acquirer's security department SOFT 66
CANCELLED_BY_USER Cancelled by user SOFT -
CHECKING_ACCOUNT No checking account SOFT 52
COUNTRY_NOT_SUPPORTED This transaction cannot be processed due to an unsupported country SOFT -
CURRENCY_NOT_ALLOWED Currency not allowed SOFT -
CUSTOMER_NOT_FOUND No account found for the customer ID SOFT -
DECLINED_BY_PROVIDER Rejected by the provider. Refer to the provider_data SOFT -
DENIED No card record SOFT 56
DISABLED Restricted card SOFT -
DO_NOT_HONOR Do not honor SOFT 5
DUPLICATED_PAYMENT Duplicate transmission of the payment SOFT 94
DUPLICATED_TRANSACTION Duplicate transmission of the transaction SOFT 94
EXPIRED Expired alternative payment method SOFT
EXPIRED_CARD Expired card SOFT 54
FIRST_USE Blocked first use SOFT 78
FRAUD_VALIDATION Security violation SOFT 59, 63, 64
FRAUD_VERIFICATION_DECLINED - - -
INSUFFICIENT_FUNDS Not sufficient funds HARD 51
INVALID_ACCOUNT Invalid account number SOFT -
INVALID_AMOUNT Invalid amount SOFT 61
INVALID_CARD_DATA Card does not match the parameters from the issuer. SOFT 30,89
INVALID_CARD_NUMBER Card does not match the parameters from the issuer. SOFT 30,89
INVALID_API Trying to verify the payment with an unauthorized IP address N/A -
INVALID_API_VERSION Invalid API version SOFT -
INVALID_CREDENTIALS Fraud provider invalid credentials set in Yuno. N/A -
INVALID_DATE_FORMAT Invalid date format SOFT -
INVALID_ISSUER Invalid issuer SOFT 15
INVALID_MERCHANT Invalid merchant or service provider SOFT 3
INVALID_PARAMETERS Invalid parameters SOFT -
INVALID_SECURITY_CODE Invalid card's security code HARD 39
INVALID_RESPONSE_FORMAT The response body returned by provider has an invalid format SOFT -
INVALID_STATUS Invalid status SOFT -
INVALID_TOKEN Invalid token SOFT -
INVALID_TRANSACTION The transaction being attempted is invalid SOFT 12
ISSUER_VIOLATION The issuing bank rejected the transaction due to some violation related to the account. SOFT 93
MISSING_PARAMETERS Missing parameters SOFT -
PAYMENT_NOT_FOUND Payment not found SOFT -
PIN_ERROR Incorrect PIN for the card HARD 55, 86
REFUND_IN_PROCESS There is already a refund in process for the transaction N/A -
REJECTED_THREE_D_SECURE_REQUIRED 3DS validation rejection SOFT -
REJECTED_SAVING_ACCOUNT No savings account SOFT 53
REPORTED_LOST Lost card HARD 41
REPORTED_STOLEN Stolen card, pick-up HARD 43
REQUESTS_EXCEEDED Requests limit for the provider account reached. N/A -
RESTRICTED_BY_BANK Rejected by the bank. Refer to card issuer's special conditions SOFT -
TERMINAL_ERROR Your merchant account is not properly configured for the transaction SOFT 58
TRANSACTION_NOT_FOUND Transaction not found SOFT -
UNAVAILABLE_PAYMENT_METHOD Requested function not supported SOFT -
UNSUPPORTED_METHOD Unsupported method SOFT -
UNSUPPORTED_OPERATION Requested function not supported SOFT 40, 62
UNKNOWN_ERROR Unknown error SOFT -
UNKNOWN_IP_ADDRESS Unknown IP address SOFT -
USER_RESTRICTION Transaction not permitted for cardholder SOFT 57

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 An Error occurred during the Chargeback N/A -
PROVIDER ERROR Error. An unknown error occurred during the authorization SOFT -
PROVIDER_INTERNAL_ERROR Internal error SOFT -
PROVIDER INVALID_CREDENTIALS Invalid credentials SOFT -
PROVIDER_INVALID_REQUEST Invalid request SOFT -
PROVIDER_TIMEOUT Response received too late SOFT 68
PROVIDER_UNKNOWN_ERROR Unknown error SOFT -
TO_REVERSE The transaction will be reversed HARD -
PROVIDER_INVALID_RESPONSE Invalid response HARD -
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 -