Testing result codes with Classic API

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