Skip to main content
POST
/
api
/
v2.1
/
fincard
/
virtual
/
card
/
info
Card Info
curl --request POST \
  --url https://sandbox.finhub.cloud/api/v2.1/fincard/virtual/card/info \
  --header 'Content-Type: application/json' \
  --header 'X-Forwarded-From: <x-forwarded-from>' \
  --data '
{
  "cardId": "<string>",
  "simpleInfo": true
}
'
{
  "success": true,
  "code": 200,
  "msg": "Success",
  "data": {
    "cardId": "card-12345678",
    "cardToken": "tok_12345678",
    "maskedCardNumber": "**** **** **** 4242",
    "expiryDate": "12/25",
    "cardStatus": "ACTIVE",
    "cardType": "VIRTUAL",
    "brand": "VISA",
    "currency": "USD",
    "accountId": "wsb-12345678",
    "cardholderId": "ch-12345678",
    "cardName": "My Virtual Card",
    "availableBalance": 1000,
    "currentBalance": 1000,
    "blockedAmount": 0,
    "spendingLimit": 5000,
    "dailyLimit": 1000,
    "monthlyLimit": 10000,
    "dailySpent": 100,
    "monthlySpent": 500,
    "createTime": 1640995200000,
    "updateTime": 1640995200000,
    "activateTime": 1640995200000,
    "expireTime": 1767225600000,
    "settings": {
      "enableOnline": true,
      "enableInternational": true,
      "enableContactless": true,
      "enableAtm": true,
      "allowedMcc": [
        "5411",
        "5812"
      ],
      "blockedMcc": [
        "7995"
      ],
      "pinFreeAmount": 100,
      "autoLoad": false,
      "autoLoadAmount": 1000,
      "autoLoadThreshold": 100
    },
    "limits": {
      "spendingLimit": 5000,
      "dailyLimit": 1000,
      "monthlyLimit": 10000,
      "perTransactionLimit": 2500,
      "atmDailyLimit": 500,
      "atmPerTransactionLimit": 300
    },
    "features": [
      "CHIP",
      "NFC",
      "3DS"
    ]
  }
}

Headers

User-Agent
string

User agent

X-Forwarded-For
string

Forwarded for

X-Forwarded-From
string
required

Client application identifier

Example:

"client-app"

X-Tenant-ID
string

Tenant ID

deviceId
string

Device ID

platform
string

Platform

Body

application/json

Card info request

Card info request

cardId
string
required

Card ID

simpleInfo
boolean

Return only basic info (no balance). Default true

Response

Successful response

Card info response

success
boolean

Success flag

Example:

true

code
integer<int32>

Response code

Example:

200

msg
string

Response message

Example:

"Success"

data
object

Card data