Test Cards

The following cards can be used with the test API to simulate various success and error scenarios.

Standard responses

Successful Response

  • 4200000000000000
  • 5520000000000000
  • 372000000000000
  • 3528800000000000
  • 6011200000000000
    6510000000000000
  • 3640000000000000

Card Declined

  • 4100000000000001
  • 5560000000000001
  • 371000000000001
  • 3528300000000001
  • 6011600000000001
    6550000000000001
  • 3680000000000001

400 card_declined

{
  "error": "card_declined",
  "error_description": "The card was declined",
  "charge_token": "ch_lfUYEBK14zotCTykezJkfg"
}

Insufficient Funds

  • 4000000000000002
  • 5510000000000002
  • 370000000000002
  • 3528700000000002
  • 6011100000000002
    6500000000000002
  • 3630000000000002

400 insufficient_funds

{
  "error": "insufficient_funds",
  "error_description": "There are not enough funds available to process the requested amount",
  "charge_token": "ch_lfUYEBK14zotCTykezJkfg"
}

Invalid CVV

  • 4900000000000003
  • 5550000000000003
  • 379000000000003
  • 3528200000000003
  • 6011500000000003
    6590000000000003
  • 3670000000000003

400 invalid_cvv

{
  "error": "invalid_cvv",
  "error_description": "The card verification code (cvc) was not in the correct format",
  "charge_token": "ch_lfUYEBK14zotCTykezJkfg"
}

Invalid Card

  • 4800000000000004
  • 5500000000000004
  • 378000000000004
  • 3528600000000004
  • 6011000000000004
    6540000000000004
  • 3620000000000004

400 invalid_card

{
  "error": "invalid_card",
  "error_description": "The card was invalid",
  "charge_token": "ch_lfUYEBK14zotCTykezJkfg"
}

Processing Error

  • 4700000000000005
  • 5590000000000005
  • 377000000000005
  • 3528100000000005
  • 6011900000000005
    6580000000000005
  • 3660000000000005

400 processing_error

{
  "error": "processing_error",
  "error_description": "An error occurred while processing the card",
  "charge_token": "ch_lfUYEBK14zotCTykezJkfg"
}

Suspected Fraud

  • 4600000000000006
  • 5540000000000006
  • 376000000000006
  • 3528500000000006
  • 6011400000000006
    6530000000000006
  • 3610000000000006

400 suspected_fraud

{
  "error": "suspected_fraud",
  "error_description": "The transaction was flagged as possibly fraudulent and subsequently declined",
  "charge_token": "ch_lfUYEBK14zotCTykezJkfg"
}

Gateway Error

  • 4300000000000009
  • 5570000000000009
  • 373000000000009
  • 3528400000000009
  • 6011700000000009
    6560000000000009
  • 3690000000000009

502 gateway_error

{
  "error": "gateway_error",
  "error_description": "An upstream error occurred while processing the transaction. Please try again.",
  "charge_token": "ch_lfUYEBK14zotCTykezJkfg"
}

Unknown

  • 4400000000000099
  • 5530000000000099
  • 374000000000099
  • 3528900000000099
  • 6011300000000099
    6520000000000099
  • 3600000000000099

400 unknown

{
  "error": "unknown",
  "error_description": "Sorry, an unknown error has occurred. This is being investigated"
}

Invalid Expiry

To simulate an invalid expiry date, provide the API with an expiry date in the past.

3D Secure

The following cards can be used with the test API to elicit a simulated 3D Secure process.

3D Secure challenge flow

  • 4242424242424242
  • 5200862422134742

202 accepted

{
  "token": "ch_lfUYEBK14zotCTykezJkfg",
  "status_message": "Pending",
  "redirect_url": "https://sandbox.checkout.com/api2/v2/3ds/acs/sid_feixbit6us3utfedjulm6egnsu"
}

3D Secure frictionless flow

  • 4539164428142547
  • 5309961755464047

202 accepted

{
  "token": "ch_lfUYEBK14zotCTykezJkfg",
  "status_message": "Pending",
  "redirect_url": "https://sandbox.checkout.com/api2/v2/3ds/acs/sid_feixbit6us3utfedjulm6egnsu"
}

3D Secure challenge flow failure

  • 4532776623785148
  • 5248227798896148

202 accepted

{
  "token": "ch_lfUYEBK14zotCTykezJkfg",
  "status_message": "Pending",
  "redirect_url": "https://sandbox.checkout.com/api2/v2/3ds/acs/sid_feixbit6us3utfedjulm6egnsu"
}

After following the redirect URL and completing the challenge, verifying the charge will result in a declined card error.

200

{
  "success": false,
  "token": "ch_lfUYEBK14zotCTykezJkfg",
  "status_message": "Card Declined",
  "error_message": "Card Declined"
}

Note the above is just a snippet of the returned response. View the full schema ›

3D Secure frictionless flow failure

  • 4103112242852649
  • 5135062921901549

202 accepted

{
  "token": "ch_lfUYEBK14zotCTykezJkfg",
  "status_message": "Pending",
  "redirect_url": "https://sandbox.checkout.com/api2/v2/3ds/acs/sid_feixbit6us3utfedjulm6egnsu"
}

After following the redirect URL, verifying the charge will result in a declined card error.

200

{
  "success": false,
  "token": "ch_lfUYEBK14zotCTykezJkfg",
  "status_message": "Card Declined",
  "error_message": "Card Declined"
}

Note the above is just a snippet of the returned response. View the full schema ›