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 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_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 -
BAD_FILLED_INFO Card does not match the parameters from the issuer HARD 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 17
COUNTRY_NOT_SUPPORTED This transaction cannot be processed due to an unsupported country HARD -
CURRENCY_NOT_ALLOWED Currency not allowed HARD -
DECLINED_BY_PROVIDER Rejected by the provider. Refer to the provider_data SOFT -
DISABLED Restricted card SOFT -
DO_NOT_HONOR Do not honor SOFT 5
DUPLICATED_TRANSACTION Duplicate transmission of the transaction SOFT 26,94
EXPIRED Expired alternative payment method SOFT
EXPIRED_CARD Expired card SOFT 33,54
FIRST_USE Blocked first use SOFT 78
FRAUD_VALIDATION Security violation SOFT 34, 59, 63, 64
FRAUD_VERIFICATION_DECLINED - - -
INSUFFICIENT_FUNDS Not sufficient funds SOFT 51
INVALID_AMOUNT Invalid amount SOFT 13,64
INVALID_CARD_DATA Card does not match the parameters from the issuer. HARD 56
INVALID_CARD_NUMBER Card does not match the parameters from the issuer. HARD 14
INVALID_API Trying to verify the payment with an unauthorized IP address HARD -
INVALID_API_VERSION Invalid API version HARD -
INVALID_CREDENTIALS Fraud provider invalid credentials set in Yuno. HARD -
INVALID_ISSUER Invalid issuer SOFT 15
INVALID_MERCHANT Invalid merchant or service provider SOFT 3
INVALID_PARAMETERS Invalid parameters HARD -
INVALID_SECURITY_CODE Invalid card's security code HARD 56,82
INVALID_STATUS Invalid status SOFT -
INVALID_RESPONSE_FORMAT The response body returned by the provider has an invalid format SOFT -
INVALID_TRANSACTION The transaction being attempted is invalid HARD 12,23
ISSUER_VIOLATION The issuing bank rejected the transaction due to some violation related to the account. SOFT 93
MISSING_PARAMETERS Missing parameters HARD -
REJECTED_THREE_D_SECURE_REQUIRED 3DS validation rejection SOFT -
REPORTED_LOST Lost card HARD 41
REPORTED_STOLEN Stolen card, pick-up HARD 43
REQUESTS_EXCEEDED Requests limit for the provider account reached. SOFT -
RESTRICTED_BY_BANK Rejected by the bank. Refer to card issuer's special conditions SOFT 62
TERMINAL_ERROR Your merchant account is not properly configured for the transaction SOFT 58
TRANSACTION_NOT_FOUND Transaction not found HARD 25/td>
UNAVAILABLE_PAYMENT_METHOD Requested function not supported HARD -
UNSUPPORTED_OPERATION Requested function not supported HARD 40
UNKNOWN_ERROR Unknown error SOFT -
USER_RESTRICTION Transaction not permitted for cardholder HARD 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 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 -