Last Updated: 09 April 2024 | Change Log

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:

• Card payment testing
  • Test card numbers
  • Issuer response test values
  • Raw response code test values
  • Refusal advice test values
  • CVC test values
    • Testing CVC
    • Testing CVC (American Express)
  • AVS test values
    • Testing AVS
    • AVS responses
    • Exemption test values
  • Online refund test values

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).

Issuer response test values

Input these magic values in your paymentInstrument.cardHolderName parameter.

Raw response code test values

Input these magic values in your paymentInstrument.cardHolderName parameter to return the rawCode. Note that these responses are specific to card schemes, so your test cardNumber should match the card scheme.

Refusal advice test values

Input these magic values in your paymentInstrument.cardHolderName parameter to get the refusalAdvice object in a Refused response.

The results are returned in this format:

{
    "outcome": "refused",
    "refusalCode": "83",
    "refusalDescription": "Fraud/Security related reasons",
    "riskFactors": [
        {
            "type": "riskProfile",
            "risk": "verificationFailed"
        },
        {
            "type": "cvc",
            "risk": "notMatched"
        },
        {
            "type": "avs",
            "risk": "notMatched",
            "detail": "address"
        },
        {
            "type": "avs",
            "risk": "notChecked",
            "detail": "postcode"
        }
    ]
}

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.

Testing CVC (American Express)

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

AVS test values

Use these values to test AVS responses.

Testing AVS

Use these magic values in the postalCode attribute in your request. You'll get responses for postcode checks and for address checks in the riskFactors object.

AVS responses

Exemption test values

Submit the values from the magic value column in the cardHolderName to test the different issuer responses when applying an exemption.

The three possible exemption result outcomes are covered by the test values below but not all the reason values.

Online refund test values

Submit the values from the magic value column in the value.amount field in a partial refund request to test different scenarios related to online refunds. The response to your partial refund request is a standard http status 202 response, but the refund outcome will come via an Events webhook.