Issue a virtual card

POST

/v1/cards/b2b-virtual/issue

Issues a USD virtual card with an opening balance paid from your wallet.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Success

Bodyapplication/json

🟠400

🟠401

🟠403

🟠409

🟠429

Request Example

Shell

JavaScript

Java

Swift

curl --location 'http://localhost:5050/v1/cards/b2b-virtual/issue' \
--header 'Idempotency-Key;' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "cardName": "Ada Lovelace",
    "initialFundUsd": 10
}'

Response Example

200 - Success

{
    "success": true,
    "message": "USD Virtual Card created successfully",
    "statusCode": 200,
    "path": "/v1/…",
    "timestamp": "2026-09-26T12:00:00.000Z",
    "hash": "a1b2c3d4-…",
    "data": {
        "card": {
            "cardId": "vc_9f3k2",
            "cardName": "Ada Lovelace",
            "cardNumber": "5399 **** **** 4821",
            "expiry": "09/29",
            "balance": 10,
            "currency": "USD",
            "status": "ACTIVE"
        }
    }
}

Modified at 2026-10-05 12:29:02

Print a batch (data and layout)

List transactions