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