Workflow
Types of transactions
| Type | Description |
|---|---|
PURCHASE | A direct purchase transaction. |
AUTHORIZE | Transaction associated with authorization. Mainly for card payments. |
CAPTURE | A capture of a previously authorized transaction. |
REFUND | A refund of a previously approved transaction. |
CANCEL | A cancelation of a previously pending transaction. |
VERIFY | Transaction associated with a credit card verification. |
CHARGEBACK | Transaction associated with a chargeback. |
THREE_D_SECURE | A 3DS verification transaction for an initial purchase. |
FRAUD_SCREENING | Fraud screening is associated with fraud verification. |
Transaction codes
With every transaction, you´ll receive aresponse_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
Won status
Created status
Pending status
Declined status
Rejected status
Error status
Expired status
Lost status
Prevented status
Succeeded status
`SUCCEEDED` status details
`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
`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
`CREATED` status details
| response_code | Description | Hard/Soft decline | ISO 8583 code |
|---|---|---|---|
ACTION_REQUIRED | Payment created but requires additional user action. This occurs in 3D Secure authentication flows, payment method redirections, Headless SDK flows requiring continuePayment, or async payment methods with additional steps. Check the redirect_url or sdk_action_required field for next steps. | N/A | - |
SUCCEEDED | Transaction created successfully | N/A | - |
RECEIVED | Transaction received | N/A | - |
Pending status
`PENDING` status details
`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
Some declines include a
merchant_advice_code (MAC) that indicates whether and when to retry. See Merchant Advice Codes (MAC).`DECLINED` status details
`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_ATTEMPT | Authentication attempt without completion | N/A | - |
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_BANK | Rejected by the bank. Refer to card issuer | SOFT | - |
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 | HARD | 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 | - |
NO_RETRY_LIFE_CYCLE | No retry life cycle | HARD | 79 |
NO_RETRY_POLICY | No retry policy | HARD | 82 |
NO_RETRY_SECURITY | No retry security | HARD | 83 |
RETRY_AFTER_1_H | Retry after 1 hours | HARD | |
RETRY_AFTER_24_H | Retry after 24 hours | HARD | |
RETRY_AFTER_2_D | Retry after 2 days | HARD | |
RETRY_AFTER_4_D | Retry after 4 days | HARD | |
RETRY_AFTER_6_D | Retry after 6 days | HARD | |
RETRY_AFTER_8_D | Retry after 8 days | HARD | |
RETRY_AFTER_10_D | Retry after 10 days | HARD | |
REJECTED_THREE_D_SECURE_REQUIRED | 3DS validation rejection | SOFT | - |
REFER_TO_CARD_ISSUER | Rejected by the bank. Refer to card issuer | SOFT | 01 |
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 |
THREE_D_SECURE_REQUIRED | Antifraud provider requires a 3DS challenge for further validation. | SOFT | |
TRANSACTION_NOT_FOUND | Transaction not found | HARD | 25 |
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 |
Merchant Advice Codes (MAC)
These codes will provide useful guidance when dealing with declined transactions. You may find these fields in our public API responses:transactions.merchant_advice_codeandtransactions.merchant_advice_code_message: Yuno-normalized fields providing standardized codes and explanations regarding the denial.transactions.provider_data.merchant_advice_codeandtransactions.merchant_advice_code_message: Raw code and message from the provider.
Merchant Advice Codes (MAC)
Merchant Advice Codes (MAC)
Merchant Advice Codes provide guidance from issuers/providers about retry behavior and policy. When present on a decline, use the MAC to determine whether to retry and the recommended timing.
| merchant_advice_code | Description | Provider MAC code |
|---|---|---|
UPDATE_INFORMATION | Updated/additional information needed | 01 – Updated account information available |
TRY_AGAIN_LATER | Retry after 10 days | 02 – Try again later |
DO_NOT_TRY_AGAIN | Do not try again | 03 – Do not try again |
REQUIREMENTS_NOT_FULFILLED | Token requirements not fulfilled | 04 – Token requirements not fulfilled |
NO_RETRY_LIFE_CYCLE | No retry life cycle | 21 – Recurring plan cancelled |
RETRY_AFTER_1_H | Retry after 1 hour | 24 – Retry after 1 hour (insufficient funds) |
RETRY_AFTER_24_H | Retry after 24 hours | 25 – Retry after 24 hours (insufficient funds) |
RETRY_AFTER_2_D | Retry after 2 days | 26 – Retry after 2 days (insufficient funds) |
RETRY_AFTER_4_D | Retry after 4 days | 27 – Retry after 4 days (insufficient funds) |
RETRY_AFTER_6_D | Retry after 6 days | 28 – Retry after 6 days (insufficient funds) |
RETRY_AFTER_8_D | Retry after 8 days | 29 – Retry after 8 days (insufficient funds) |
RETRY_AFTER_10_D | Retry after 10 days | 30 – Retry after 10 days (insufficient funds) |
NO_RETRY_POLICY | No retry policy | 40 – Non‑rechargeable prepaid card |
NO_RETRY_SECURITY | No retry security | 42 – Sanction score exceeded |
MULTIPLE_USE_CARD | Multiple‑use virtual card | 43 – Multiple‑use virtual card |
Rejected status
`REJECTED` status details
`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
`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
`EXPIRED` status details
| response_code | Description | Hard/Soft decline | ISO 8583 code |
|---|---|---|---|
EXPIRED_BY_PROVIDER | - | N/A | - |
Lost status
`LOST` status details
`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 | - |
Prevented status
`PREVENTED` status details
`PREVENTED` status details
| response_code | Description | Hard/Soft decline | ISO 8583 code |
|---|---|---|---|
PREVENTED | Predispute deflected by provider/network. No evidence required. Terminal. | N/A | - |
PREVENTED is only applicable to transactions with type = CHARGEBACK when the provider/network indicates a predispute deflection. In these scenarios, Yuno emits only the chargeback webhook; no refund webhook is sent.Chargebacks specific response_codes
For more details, please refer to the reason codes page in the Chargeback guides section.`CREATED` status details
`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. |