# API Create List Virtual Cards

**Endpoint: POST /v2/vc/virtual-cards/batch**

**Description: Create a batch of virtual cards under a specified card policy.**

### Request

**Request Body Field Descriptions (JSON)**

| Field Name                           | Type   | Required | Description                                                      |
| ------------------------------------ | ------ | -------- | ---------------------------------------------------------------- |
| requestId                            | string | Yes      | Unique batch request ID (*UUID recommended*)                     |
| cardPolicy                           | string | Yes      | Card policy request ID to apply to all cards                     |
| virtualCards                         | array  | Yes      | List of virtual card creation objects                            |
| virtualCards\[].virtualCardRequestId | string | Yes      | Unique request ID for each virtual card                          |
| virtualCards\[].cardHolderName       | string | Yes      | Name of the card holder                                          |
| virtualCards\[].cardBrand            | string | No       | Card brand (If not provide, cardBrand on policy will be applied) |
| virtualCards\[].extraInfo            | object | No       | Additional information (optional)                                |

**Request sample**

```json
{
  "requestId": "b1e2c3d4-5678-1234-9abc-1234567890ab",
  "cardPolicy": "e424ae34-5c56-45c8-882e-98c4325981d3",
  "virtualCards": [
    {
      "virtualCardRequestId": "a1b2c3d4-5678-1234-9abc-1234567890ab",
      "cardHolderName": "John Doe",
      "cardBrand": "mastercard"
    },
    {
      "virtualCardRequestId": "b2c3d4e5-6789-2345-9bcd-2345678901bc",
      "cardHolderName": "Jane Smith",
      "cardBrand": "visa"
    }
  ]
}
```

#### Response

**Response Field Descriptions**

| Field Name     | Type   | Description                                     |
| -------------- | ------ | ----------------------------------------------- |
| code           | number | Response code                                   |
| state          | number | State of the response                           |
| data.requestId | object | Detail data of batch VirtualCard create request |
| message        | string | Response message                                |
| neoResponseId  | string | Unique Neo response identifier                  |

**`data` object fields:**

| Field Name   | Type   | Description                                      |
| ------------ | ------ | ------------------------------------------------ |
| requestId    | string | Unique request identifier                        |
| merchantCode | string | Merchant code                                    |
| createdAt    | string | Creation timestamp (ISO 8601)                    |
| status       | string | Status of the batch creation (default: "PASSED") |
| message      | string | Processing message                               |

**Response sample**

```json
{
  "code": 1,
  "state": 2,
  "data": {
    "requestId": "14453285-93d2-4fef-8a3e-fa6b8a99cf6f",
    "merchantCode": "COLRLC",
    "createdAt": "2025-06-04T01:15:39.529Z",
    "status": "PASSED",
    "message": "Please wait while we are processing your request"
  },
  "message": "Successful",
  "neoResponseId": "c3f228b8-fc58-45c2-a01c-e954d1225635"
}
```

### Example cURL

```bash
curl -X POST "https://{base_url_openapi}/v2/vc/virtual-cards/batch" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Content-Type: application/json" \
  -H "Accept-Language: en" \
  -d '{
    "requestId": "b1e2c3d4-5678-1234-9abc-1234567890ab",
    "cardPolicy": "e424ae34-5c56-45c8-882e-98c4325981d3",
    "virtualCards": [
      {
        "virtualCardRequestId": "a1b2c3d4-5678-1234-9abc-1234567890ab",
        "cardHolderName": "John Doe",
        "cardBrand": "mastercard"
      },
      {
        "virtualCardRequestId": "b2c3d4e5-6789-2345-9bcd-2345678901bc",
        "cardHolderName": "Jane Smith",
        "cardBrand": "visa"
      }
    ]
  }'
```

#### Notes

* Requires Bearer token in the Authorization header.
* The Accept-Language header can be used to specify the response language (Support: "vi", "en").
* The request body must be in JSON format.
* Use a unique `requestId` for each request to avoid duplicate creations.
* Use a unique `virtualCardRequestId` for each virtual card to avoid duplicate creations.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.neox.vn/docs/global/virtual-card/virtual-cards/apis/api-create-virtual-cards.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.