Create a virtual card viewing session

POST

/virtual-card-sessions

Issues a short-lived session token that grants temporary access to view a virtual card's sensitive details (e.g. full card number, CVV) through a dedicated viewing flow, without repeatedly exposing that data through the main card endpoints. The session expires 10 minutes after creation. Creation fails if the card is pending-approval or terminated.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

The viewing session was created successfully.

Bodyapplication/json

🟠400

🟠401

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location '/virtual-card-sessions' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "virtual_card_id": "01HXYZ9876543210ZYXWVUTSRQ"
}'

Response Example

201 - Success

{
    "message": "Virtual card session created successfully",
    "status": "success",
    "data": {
        "id": "01J8ZK3QANDSESSION00000A1",
        "virtual_card_id": "01HXYZ9876543210ZYXWVUTSRQ",
        "session_token": "9f8a1c2d3e4f5061728394a5b6c7d8e9f0a1b2c3d4e5f60718293a4b5c6d7e8",
        "expires_at": 1782900600000
    }
}

Modified at 2026-09-30 00:29:30

List a virtual card's activity

Top up a virtual card