---
title: "Create Virtual Card"
method: POST
path: "/v1/cards"
tags: ["Cards"]
---

# Create Virtual Card

`POST /v1/cards`

Creates a new virtual card with the provided details.

## Request body

- CardsWithActorId — Represents the details required to create or update a card associated with an actor, including card attributes and contact information.
  - `ActorID` integer, nullable — The unique identifier of the actor associated with the card.
  - `CardUniqueIdentifier` string, nullable — The unique identifier assigned to the card.
  - `CardDisplayNumber` string, nullable — The display number of the card.
  - `CardHolderName` string, nullable — The name of the cardholder.
  - `CardStatus` unknown
  - `CardType` 31 | 33 | 34 | 30000616, nullable — The type identifier of the card.
  - `CardUserIdentity` string, nullable — The unique identity or user ID associated with the card.
  - `CountryID` integer, nullable — The identifier of the country associated with the card. Use the [Get Countries](ref:get-countries) endpoint for a full list of available countries.
  - `Currency` integer, nullable — The currency identifier used for the card. Use the [Get Currencies](ref:get-currencies) endpoint for a full list of available currencies.
  - `MobileNumber` string, nullable — The mobile number associated with the card.
  - `Email` string, nullable — The email address associated with the card.
  - `CardPhysicalType` integer, nullable — The physical type identifier of the card.
  - `MemberType` integer, nullable — The membership type identifier associated with the card.
  - `CardActivationDate` string, date-time, nullable — The date and time when the card becomes active.
  - `CardExpirationDate` string, date-time, nullable — The date and time when the card expires.
  - `CardImageUrl` string, nullable — The URL of the image associated with the card.
  - `CardNote` string, nullable — Any additional notes associated with the card.
  - `wd_limits_money` string, nullable — The monetary limits applied to the card on specific weekdays.
  - `wd_limits_trans` string, nullable — The transaction limits applied to the card on specific weekdays.
  - `use_wd_limit` boolean, nullable — Indicates whether the weekday limits are enabled for the card.

## Response `200`

The virtual card was created successfully.

- Cards — Represents the details of a card, including its attributes, status, and associated actor information.
  - `MobileNumber` string, nullable — The mobile number associated with the card.
  - `CardID` integer, nullable — The unique identifier of the card.
  - `ActorID` integer, nullable — The unique identifier of the actor associated with the card.
  - `CardUniqueIdentifier` string, nullable — The unique identifier assigned to the card.
  - `CardDisplayNumber` string, nullable — The display number of the card.
  - `CardHolderName` string, nullable — The name of the cardholder.
  - `CardStatus` integer, nullable — The current status of the card.
  - `CardType` integer, nullable — The type identifier of the card.
  - `CardUserIdentity` string, nullable — The unique identity or user ID associated with the card.
  - `UpdatedDt` string, date-time, nullable — The date and time when the card was last updated.
  - `CreatedDt` string, date-time, nullable — The date and time when the card was created.
  - `CreatedBy` integer, nullable — The identifier of the user who created the card.
  - `UpdatedBy` integer, nullable — The identifier of the user who last updated the card.
  - `CountryID` integer, nullable — The identifier of the country associated with the card.
  - `Email` string, nullable — The email address associated with the card.
  - `CardPhysicalType` integer, nullable — The physical type identifier of the card.
  - `MemberType` integer, nullable — The membership type identifier associated with the card.
  - `CardActivationDate` string, date-time, nullable — The date and time when the card becomes active.
  - `CardExpirationDate` string, date-time, nullable — The date and time when the card expires.
  - `CardImageUrl` string, nullable — The URL of the image associated with the card.
  - `CardNote` string, nullable — Any additional notes associated with the card.
  - `wd_limits_money` string, nullable — The monetary limits applied to the card on specific weekdays.
  - `wd_limits_trans` string, nullable — The transaction limits applied to the card on specific weekdays.
  - `use_wd_limit` boolean, nullable — Indicates whether the weekday limits are enabled for the card.
  - `CardExternalApplicationUserID` string, nullable — The external application user ID associated with the card.
  - `Refs` object, nullable — Additional references or metadata associated with the card.

---

[API](https://skmtc.net/nayax/apis/nayax-cortina-api.md) · [All operations](https://skmtc.net/nayax/apis/nayax-cortina-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nayax/nayax-cortina-api/revisions/421f6f83c257/schema)