---
title: "Creates one or more test card ranges."
method: POST
path: "/createTestCardRanges"
tags: ["General"]
---

# Creates one or more test card ranges.

`POST /createTestCardRanges`

Creates one or more test card ranges.

## Request body

- CreateTestCardRangesRequest
  - `accountCode` string, required — The code of the account, for which the test card ranges should be created.
  - `accountTypeCode` string, required — The type of the account, for which the test card ranges should be created. Permitted values: * Company * MerchantAccount > These values are case-sensitive.
  - `testCardRanges` TestCardRange[], required — A list of test card ranges to create.
    - `address` AvsAddress
      - `streetAddress` string, required — The street and house number of the address. Example: 1 Infinite Loop, Cupertino.
      - `zip` string — The zip or post code of the address. Example: CA 95014
    - `cardHolderName` string, required — The name of the card holder, as it appears on the card, for the test card range.
    - `cvc` string — The test card range security code. Example: 123
    - `expiryMonth` 'APRIL' | 'AUGUST' | 'DECEMBER' | 'FEBRUARY' | 'JANUARY' | 'JULY' | 'JUNE' | 'MARCH' | 'MAY' | 'NOVEMBER' | 'OCTOBER' | 'SEPTEMBER', required — Expiry month for the test card range. Allowed values: * JANUARY * FEBRUARY * MARCH * APRIL * MAY * JUNE * JULY * AUGUST * SEPTEMBER * OCTOBER * NOVEMBER * DECEMBER
    - `expiryYear` integer, required — Expiry year for the test card range. Example: 2020
    - `rangeEnd` string, required — The last test card number in the test card range (inclusive): * Min 6, max 19 digits * BIN compliant Example: 5432 1234 1234 4321
    - `rangeStart` string, required — The first test card number in the test card range (inclusive): * Min 6, max 19 digits * BIN compliant Example: 5432 1234 1234 1234
    - `threeDDirectoryServerResponse` 'N' | 'U' | 'Y' — 3D Secure server response. It notifies whether the specified card holder is enrolled in a 3D Secure service. Possible values: * Y (Authentication available) * N (Card holder not enrolled/not participating) * U (Unable to authenticate)
    - `threeDPassword` string — The password used for 3D Secure authentication.
    - `threeDUsername` string — The username used for 3D Secure authentication.

## Response `200`

OK - the request has succeeded.

- CreateTestCardRangesResult
  - `rangeCreationResults` TestCardRangeCreationResult[], required — The results of the test card creation.
    - `cardNumberRangeEnd` string, required — The last test card number in the generated test card range. Example: 5432 1234 1234 4321
    - `cardNumberRangeStart` string, required — The first test card number in the generated test card range. Example: 5432 1234 1234 1234
    - `creationResultCode` 'ALREADY_EXISTS' | 'CREATED' | 'ERROR', required — Notification message. It informs about the outcome of the operation. Possible values: * CREATED * ALREADY_EXISTS * ERROR
    - `message` string — An optional information message about the result.

## Other responses

- `400` — Bad Request - a problem reading or understanding the request.
- `401` — Unauthorized - authentication required.
- `403` — Forbidden - insufficient permissions to process the request.
- `422` — Unprocessable Entity - a request validation error.
- `500` — Internal Server Error - the server could not process the request.

## Changes

- **2021-08-07** (v1) `a97e38a3b16d` — 3 info
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - the endpoint scheme security `BasicAuth` was added to the API
  - api tag `General` added
- **2021-04-10** (v1) `827e6236e0ef` — 5 info
  - added the optional property `status` to the response with the `400` status
  - added the optional property `status` to the response with the `401` status
  - added the optional property `status` to the response with the `403` status
  - added the optional property `status` to the response with the `422` status
  - …1 more
- **2021-03-05** (v1) `bc932b17a7d0` — 5 info
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `401`
  - added the media type `application/json` for the response with the status `403`
  - added the media type `application/json` for the response with the status `422`
  - …1 more
- **2020-08-05** (v1) `25d5f01cb4f0` — 1 info
  - api operation id `post-createTestCardRanges` was added

[Change history](https://skmtc.dev/adyen/apis/adyen-test-cards-api/changes/createTestCardRanges/post.md)

---

[API](https://skmtc.dev/adyen/apis/adyen-test-cards-api.md) · [All operations](https://skmtc.dev/adyen/apis/adyen-test-cards-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adyen/adyen-test-cards-api/revisions/c94d45717d9e/schema)