Menu

Card payment testing


Test your integration with our Payments API using the magic values provided below. Send requests and see simulated responses.

On this page:

Test card numbers

For use in our try environment only.

With these cards, you can specify an expiry date up to seven years in the future. These cards do not have an issue number, a registered address or a card verification code (CVC).

Card typeTest card number
American Express343434343434343
Cartes Bancaires5555555555554444
Discover/ Diners6011000400000000
JCB3528000700000000
Maestro6759649826438453
MasterCard5555555555554444, 5454545454545454 and 2221000000000009
MasterCard Debit5163613613613613
Visa4444333322221111, 4911830000000 and 4917610000000000
Visa Debit4462030000000000 and 4917610000000000003
Visa Electron (UK only)4917300800000000

Issuer response test values

Input these magic values in your paymentInstrument.cardHolderName parameter.

Magic valueResult codeResult description
AUTHORISEDN/AAUTHORISED
REFUSEDN/AREFUSED
ERRORN/AERROR
REFUSED44HOLD CARD
REFUSED55REFUSED
REFUSED88APPROVE AFTER IDENTIFICATION
REFUSED1313INVALID AMOUNT
REFUSED1515INVALID CARD ISSUER
REFUSED1717ANNULATION BY CLIENT
REFUSED2828ACCESS DENIED
REFUSED2929IMPOSSIBLE REFERENCE NUMBER
REFUSED3333CARD EXPIRED
REFUSED3434FRAUD SUSPICION
REFUSED3838SECURITY CODE EXPIRED
REFUSED4141LOST CARD
REFUSED4343STOLEN CARD, PICK UP
REFUSED5151LIMIT EXCEEDED
REFUSED5555INVALID SECURITY CODE
REFUSED5656UNKNOWN CARD
REFUSED5757ILLEGAL TRANSACTION
REFUSED6262RESTRICTED CARD
REFUSED6363SECURITY RULES VIOLATED
REFUSED7575SECURITY CODE INVALID
REFUSED7676CARD BLOCKED
REFUSED8585REJECTED BY CARD ISSUER

The results are returned in this format:

Copied!
{
    "outcome": "refused",
    "description": "CARD EXPIRED",
    "code": "33",
    "riskFactors": [{
            "risk": "not_supplied",
            "type": "cvc"
        },
        {
            "risk": "not_checked",
            "detail": "address",
            "type": "avs"
        },
        {
            "risk": "not_checked",
            "detail": "postcode",
            "type": "avs"
        },
        {
            "risk": "verificationFailed",
            "type": "riskProfile"
        }
    ]
}

CVC test values

Use these values to test CVC responses.

Testing CVC

Use these magic values in the cvc parameter in your request. Your response in contained in the riskFactors object.

Note: A response is returned only if the check produces a conflict.

Magic valueCVC result codeCVC result description
[Left blank]riskFactors.risk : not_supplied
riskFactors.type : cvc
NOT SUPPLIED BY SHOPPER
111riskFactors.risk : not_checked
riskFactors.type : cvc
NOT SENT TO ACQUIRER
222riskFactors.risk : not_checked
riskFactors.type : cvc
NO RESPONSE FROM ACQUIRER
333riskFactors.risk : not_checked
riskFactors.type : cvc
NOT CHECKED BY ACQUIRER
444riskFactors.risk : not_matched
riskFactors.type : cvc
FAILED
555No riskFactors returnedAPPROVED

Testing CVC (American Express)

Use these magic values in the cvc parameter in your request. Your response in contained in the riskFactors object.

Note: A response is returned only if the check produces a conflict.

Magic valueCVC result codeCVC result description
[Left blank]riskFactors.risk : not_supplied
riskFactors.type : cvc
NOT SUPPLIED BY SHOPPER
1111riskFactors.risk : not_checked
riskFactors.type : cvc
NOT SENT TO ACQUIRER
2222riskFactors.risk : not_checked
riskFactors.type : cvc
NO RESPONSE FROM ACQUIRER
3333riskFactors.risk : not_checked
riskFactors.type : cvc
NOT CHECKED BY ACQUIRER
4444riskFactors.risk : not_matched
riskFactors.type : cvc
FAILED
5555riskFactors.risk : not_checked
riskFactors.type : cvc
UNKNOWN
6666No riskFactors returnedAPPROVED

AVS test values

Use these values to testAVS responses.

Testing AVS

Use these magic values in the postalCode attribute in your request. You'll get responses forpostcode checksand foraddress checksin the riskFactors object.

Note: A response is returned only if the check produces a conflict.

AVS responses

Magic valueriskFactors ResponseMeaning
AAAANo riskFactors returnedPostcode and address matched
BBBBriskFactors.risk : not_checked
riskFactors.detail : address
riskFactors.type : avs
Postcode matched; address not checked
CCCCriskFactors.risk : not_matched
riskFactors.detail : address
riskFactors.type : avs
Postcode matched; address not matched
DDDDriskFactors.risk : not_checked
riskFactors.detail : postcode
riskFactors.type : avs
Address matched; postcode not checked
EEEEriskFactors.risk : not_checked
riskFactors.detail : postcode
riskFactors.type : avs

riskFactors.risk : not_checked
riskFactors.detail : address
riskFactors.type : avs
Postcode and address not checked
FFFFriskFactors.risk : not_matched
riskFactors.detail : postcode
riskFactors.type : avs
Address matched; postcode not matched
GGGGriskFactors.risk : not_checked
riskFactors.detail : postcode
riskFactors.type : avs

riskFactors.risk : not_matched
riskFactors.detail : address
riskFactors.type : avs
Postcode not checked; address not matched
HHHHriskFactors.risk : not_supplied
riskFactors.detail : postcode
riskFactors.type : avs

riskFactors.risk : not_supplied
riskFactors.detail : address
riskFactors.type : avs
Postcode and address not supplied by customer/merchant
IIIIriskFactors.risk : not_checked
riskFactors.detail : address
riskFactors.type : avs

riskFactors.risk : not_matched
riskFactors.detail : postcode
riskFactors.type : avs
Address not checked; postcode not matched
JJJJriskFactors.risk : not_matched
riskFactors.detail : postcode
riskFactors.type : avs

riskFactors.risk : not_matched
riskFactors.detail : address
riskFactors.type : avs
Postcode and address not matched
[Left blank]riskFactors.risk : not_supplied
riskFactors.detail : postcode
riskFactors.type : avs

riskFactors.risk : not_supplied
riskFactors.detail : address
riskFactors.type : avs
Postcode and address not supplied by customer/merchant
KKKKriskFactors.risk : not_checked
riskFactors.detail : postcode
riskFactors.type : avs

riskFactors.risk : not_checked
riskFactors.detail : address
riskFactors.type : avs
Postcode and address not checked
LLLLriskFactors.risk : not_checked
riskFactors.detail : postcode
riskFactors.type : avs

riskFactors.risk : not_checked
riskFactors.detail : address
riskFactors.type : avs
Postcode and address not checked
MMMMriskFactors.risk : not_checked
riskFactors.detail : postcode
riskFactors.type : avs

riskFactors.risk : not_checked
riskFactors.detail : address
riskFactors.type : avs
Postcode and address not checked