# Create a virtual card for a user

Creates a virtual card for a user in the embedded finance system.

All fields are required.

Example request:
json
{
  "metaData": {
    "idempotencyKey": "partnerId_uuid",
    "partnerId": "partner-id",
    "partnerUserRef": "partner-user-id"
  },
  "payload": {
    "accountId": "6c9083ce-b9d6-4415-8ad1-e32050fc8f93",
    "userId": "d650dbc9-c067-40d1-9041-6bc65db27cda",
    "name": "Sam",
    "type": 1,
    "useType": 2,
    "features": {
      "domestic": true,
      "international": false,
      "eCommerce": true,
      "atm": true,
      "pos": true,
      "contactless": true
    },
    "limits": {
      "transactionEnabled": true,
      "transaction": 75000,
      "dailyEnabled": true,
      "daily": 75000,
      "monthlyEnabled": true,
      "monthly": 75000,
      "yearlyEnabled": false,
      "yearly": 0
    }
  }
}


Example response:
json
{
  "transactionData": {
    "transactionId": 1,
    "transactionType": "VIRTUAL_CARD",
    "transactionStatus": "COMPLETED",
    "failedStep": null
  },
  "payload": {
    "cardId": "97c89895-372b-48ee-81c4-3230b4dbb6fd"
  }
}

Endpoint: POST /transactions/virtual-card
Version: 1.0.0

## Request fields (application/json):

  - `metaData` (object, required)
    Standard metadata supplied with each partner request.

  - `metaData.idempotencyKey` (string, required)
    Unique idempotency key for the request.
    Example: "partnerId_uuid"

  - `metaData.partnerId` (string, required)
    Partner identifier.
    Example: "partner-id"

  - `metaData.partnerUserRef` (string, required)
    Partner-side user reference.
    Example: "partner-user-id"

  - `payload` (object, required)
    Operation-specific payload.
    Example: {"accountId":"6c9083ce-b9d6-4415-8ad1-e32050fc8f93"}

## Response 200 fields (application/json):

  - `transactionData` (object, required)
    Summary information about a saga transaction.

  - `transactionData.transactionId` (integer, required)
    Internal transaction identifier.
    Example: 1

  - `transactionData.transactionType` (string, required)
    Type of transaction performed.
    Example: "TRANSFER"

  - `transactionData.transactionStatus` (string, required)
    Current transaction status.
    Example: "COMPLETED"

  - `transactionData.failedStep` (string,null)
    Name of the failed saga step when applicable.
    Example: "BANK_SUBMITTED"

  - `payload` (object, required)
    Operation-specific response payload.
    Example: {"cardId":"97c89895-372b-48ee-81c4-3230b4dbb6fd"}