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)
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
Response
Response Field Descriptions
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:
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
Example cURL
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.
Last updated
Was this helpful?