No momento, esta página não está disponível em português
Tools-2 icon

Testing result codes with Classic API

Test getting result codes with your Classic API integration and troubleshoot issues before going live.

This page describes the testing steps if you are using the /authorise endpoint from Classic API. For testing result codes with our newer integrations, refer to

Step 1: Make a test payment request

Make a /authorise request including a value from the list of testing request values in either:

  • card.holderName
  • additionalData.RequestedTestAcquirerResponseCode

For example, to test getting resultCode: Refused with refusalReason: ExpiredCard, make either request:

Step 2: Get the result code in the response

The response includes the refusal reason:

Values for testing refusal reasons

Below is a list of values that you can specify in your /authorise request to get a specific refusal reason in the response. Setting either of the following fields to the triggering values enables you to stimulate a specific failure scenario:

  • card.holderName

    Some card-related payment methods, for example Alipay, redirect you to a simulator where you can select the payment result. In this case, the value provided as the cardholder name will be ignored.

  • additionalData.RequestedTestAcquirerResponseCode

refusalReason
resultCode holderName RequestedTestAcquirerResponseCode
Unknown Error UNKNOWN 0
- Authorised APPROVED 1
Refused Refused DECLINED 2
Referral Refused REFERRAL 3
Acquirer Error Error ERROR 4
Blocked Card Refused BLOCK_CARD 5
Expired Card Refused CARD_EXPIRED 6
Invalid Amount Refused INVALID_AMOUNT 7
Invalid Card Number Refused INVALID_CARD_NUMBER 8
Issuer Unavailable Refused ISSUER_UNAVAILABLE 9
Not supported Refused NOT_SUPPORTED 10
3D Not Authenticated Refused NOT_3D_AUTHENTICATED 11
Not enough balance Refused NOT_ENOUGH_BALANCE 12
- Received PENDING 13
Acquirer Fraud Refused ACQUIRER_FRAUD 14
Cancelled Refused CANCELLED 15
Shopper Cancelled Refused SHOPPER_CANCELLED 16
Invalid Pin Refused INVALID_PIN 17
Pin tries exceeded Refused PIN_TRIES_EXCEEDED 18
Pin validation not possible Refused PIN_VALIDATION_NOT_POSSIBLE 19
FRAUD Refused FRAUD 20
Not Submitted Refused NOT_SUBMITTED 21
FRAUD-CANCELLED Cancelled FRAUD_CANCELLED 22
Transaction Not Permitted Refused TRANSACTION_NOT_PERMITTED 23
CVC Declined Refused CVC_DECLINED 24
Restricted Card Refused RESTRICTED_CARD 25
Revocation Of Auth Refused REVOCATION_OF_AUTH 26
Declined Non Generic Refused DECLINED_NON_GENERIC 27
Withdrawal amount exceeded Refused WITHDRAWAL_AMOUNT_EXCEEDED 28
Withdrawal count exceeded Refused WITHDRAWAL_COUNT_EXCEEDED 29
- Authorised PARTIALLY_APPROVED 30
Issuer Suspected Fraud Refused ISSUER_SUSPECTED_FRAUD 31
AVS Declined Refused AVS_DECLINED 32
Card requires online pin Refused PIN_REQUIRED 33
No checking account available on Card Refused NO_CHECKING_ACCOUNT_AVAILABLE_ON_CARD 34
No savings account available on Card Refused NO_SAVINGS_ACCOUNT_AVAILABLE_ON_CARD 35
Mobile PIN required Refused MOBILE_PIN_REQUIRED 36
Contactless fallback Refused CONTACTLESS_FALLBACK 37
Authentication required Refused AUTHENTICATION_REQUIRED 38
RReq not received from DS Refused RREQ_NOT_RECEIVED 39
Current AID is in Penalty Box. Refused BAN_CURRENT_AID 40
CVM Required Restart Payment Refused CVM_REQUIRED_RESTART_PAYMENT 41
3DS Authentication Error Error THREED_SECURE_AUTHENTICATION_ERROR 42
Online PIN required Refused ONLINE_PIN_REQUIRED 43
Try another interface Refused TRY_ANOTHER_INTERFACE 44
Chip downgrade mode Refused CHIP_DOWNGRADE_MODE 45
Transaction blocked by Adyen to prevent excessive retry fees Refused ERPS_BLOCK 46