---
updatedAt: 2026-08-16T05:24:11.000Z
agentTools:
  projectIndex: https://docs.wirexapp.com/llms.txt
---

# Issue virtual card (v2)

Issues a virtual card for the specified user using delivery ID for payment processing

# OpenAPI definition

```json
{
  "components": {
    "schemas": {
      "request.CardIssueVirtualV2Request": {
        "properties": {
          "card_name": {
            "description": "Friendly name for the card that would be displayed to the user",
            "example": "My Cards",
            "type": "string"
          },
          "delivery_id": {
            "description": "Delivery ID returned from the fees invoice endpoint (POST /api/v1/cards/:type/fees/:country/payment) (required when fees are enforced)",
            "example": 12345,
            "type": "integer"
          },
          "employee_id": {
            "description": "Employee id that should be associated with the card",
            "example": "00000000-0000-0000-0000-000000000001",
            "type": "string"
          },
          "name_on_card": {
            "description": "Name that should be printed on the card",
            "example": "Acme Inc. IT Department",
            "type": "string"
          }
        },
        "type": "object"
      },
      "response.CardIssueResponse": {
        "properties": {
          "id": {
            "description": "Identifier of the card that was issued",
            "example": "00000000-0000-0000-0000-000000000001",
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "response.ErrorCategory": {
        "properties": {
          "category": {
            "type": "string"
          },
          "grpc_status_code": {
            "type": "integer"
          },
          "http_status_code": {
            "type": "integer"
          }
        },
        "type": "object"
      },
      "response.ErrorDetails": {
        "properties": {
          "details": {
            "type": "string"
          },
          "key": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "response.ErrorReason": {
        "properties": {
          "reason": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "response.ErrorResponse": {
        "properties": {
          "error_category": {
            "$ref": "#/components/schemas/response.ErrorCategory"
          },
          "error_description": {
            "type": "string"
          },
          "error_details": {
            "items": {
              "$ref": "#/components/schemas/response.ErrorDetails"
            },
            "type": "array"
          },
          "error_reason": {
            "$ref": "#/components/schemas/response.ErrorReason"
          }
        },
        "type": "object"
      }
    },
    "securitySchemes": {
      "WirexPayCorpToken": {
        "description": "Self-signed JWT token that can be obtained by logging in to the Wirex Corporate platform using its own authorization APIs.",
        "in": "header",
        "name": "Authorization",
        "type": "apiKey"
      }
    }
  },
  "info": {
    "contact": {
      "email": "company@wirexpaychain.com",
      "name": "API Support Team"
    },
    "description": "The **Wirex Corporate API** provides businesses with a seamless way to manage corporate finances using blockchain technology. It supports corporate registration, KYB verification, employee onboarding, corporate card issuance, and SEPA/ACH bank transfers—all without direct fiat interaction. Transactions are executed directly from a **non-custodial crypto account**, ensuring security, transparency, and full control over funds.",
    "title": "Wirex Corporate BaaS API",
    "version": "1.0"
  },
  "openapi": "3.0.3",
  "paths": {
    "/api/v2/cards/virtual": {
      "post": {
        "description": "Issues a virtual card for the specified user using delivery ID for payment processing",
        "requestBody": {
          "content": {
            "*/*": {
              "schema": {
                "$ref": "#/components/schemas/request.CardIssueVirtualV2Request"
              }
            }
          },
          "description": "Body data",
          "required": true,
          "x-originalParamName": "bodyData"
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/response.CardIssueResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/response.ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/response.ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "WirexPayCorpToken": [
              "su",
              "su:card",
              "w:card:new"
            ]
          }
        ],
        "summary": "Issue virtual card (v2)",
        "tags": [
          "Cards/Issuance"
        ]
      }
    }
  },
  "servers": [
    {
      "url": "https://api-business.wirexapp.com"
    },
    {
      "url": "https://api-corporate.wirexpaychain.tech"
    }
  ],
  "tags": [
    {
      "description": "The **Card Issuance API** enables the seamless issuance and management of both virtual and physical cards. Virtual cards can be generated\ninstantly and are ideal for secure online transactions. Physical cards are produced and securely shipped to end-users, with measures in\nplace to ensure safety during transit. One such measure is activation upon delivery, which prevents unauthorized use or fraudulent spending\nwhile the card is in transit.",
      "name": "Cards/Issuance"
    }
  ],
  "x-readme": {}
}
```