---
title: "Batch Create Prepaid Cards"
method: POST
path: "/open-api/v3/prepaid-cards"
tags: ["Card"]
---

# Batch Create Prepaid Cards

`POST /open-api/v3/prepaid-cards`

## Request

- Base URL: `https://api-sandbox.interlace.money`
- URL: `https://api-sandbox.interlace.money/open-api/v3/prepaid-cards`
- Auth: API key in header `x-access-token`

## Headers

- `Idempotency-Key` string, required

## Request body

- CreatePrepaidCardReqDTO[]
  - `accountId` string, uuid, required: The UUID of the Account.
  - `binId` string, required: The Id of the bin.
  - `cardMode` 'PHYSICAL_CARD' | 'VIRTUAL_CARD', required: Card mode. Example: VIRTUAL_CARD
  - `useType` string: Custom use type. Example: Online advertising
  - `label` string: Custom card label or tag
  - `cardholderId` string, required: cardholder id
  - `physicalCardDesignId` string: Physical Card Design ID.
  - `virtualCardDesignId` string: Virtual Card Design ID.
  - `ssn` string: If the card type is BB Card and the country is the United States, SSN is a mandatory parameter unless an SSN was already submitted during KYC or cardholder creation.
  - `referenceId` string, required: A unique identifier assigned by you for each card. This value must be unique per card request and will be used later to query or track the corresponding card.
  - `amount` number: The amount of the card.
  - `clientTransactionId` string: Custom client transaction ID.

## Response `200`

OK

- BatchCardRespDTO
  - `code` string: Error code
  - `message` string: Error message
  - `data` BatchCard, required
    - `batchNumber` string, required: Batch number.
    - `taskId` string, required: taskId.

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/interlace/apis/infinity-card.md) - [All operations](https://skmtc.dev/interlace/apis/infinity-card/llms.txt) - [OpenAPI document](https://skmtc.dev/interlace/apis/infinity-card/revisions/2d542b383dd3?raw)