Skip to main content

​
FinCard Virtual

FinCard Virtual provides comprehensive card issuance and management APIs, supporting virtual cards, physical cards, shared (budget) cards, and gift cards across Visa, MasterCard, and Discover networks.
Base URL: https://sandbox.finhub.cloud/api/v2.1/fincard/virtual
All endpoints use POST method with JSON body. The response envelope is always { "success": bool, "code": int, "msg": string, "data": ... }.

​
API Groups

Common

Reference data: countries, cities, mobile codes, file uploads, work orders

Accounts

Merchant accounts, balances, ledger transactions, fund transfers

Crypto Wallet

Coin list, wallet addresses, crypto deposit/withdrawal transactions

Cards

Card types, issuance, deposit/withdraw, freeze/unfreeze, cancel, transactions

Card Holders

KYC cardholder creation (B2B/B2C), update, approval status, listing

Webhooks

Real-time event notifications for card operations and transactions

​
Card Issuance Flows

Issuance Processes

Step-by-step flows for Virtual, Physical, Shared, and Gift cards

​
Quick Start: Issue a Virtual Card

​
Step 1: Get Available Card Types

POST /api/v2.1/fincard/virtual/card/v2/cardTypes
Body: {}

​
Step 2: Create Cardholder (if required)

POST /api/v2.1/fincard/virtual/card/holder/v2/create
Body: { "cardHolderModel": "B2B", "cardTypeId": 111001, ... }

​
Step 3: Create Card

POST /api/v2.1/fincard/virtual/card/v2/openCard
Body: { "merchantOrderNo": "...", "cardTypeId": 111001, "amount": 100 }

​
Step 4: Query Card Info

POST /api/v2.1/fincard/virtual/card/info
Body: { "cardNo": "FC-XXXX" }

​
Step 5: Get Sensitive Info (Card Number, CVV, Expiry)

POST /api/v2.1/fincard/virtual/card/info/sensitive
Body: { "cardNo": "FC-XXXX" }

​
Endpoint Summary

GroupEndpointsDescription
Common7Reference data, file upload, work orders
Accounts8Account CRUD, balances, ledger, transfers
Crypto Wallet4Coins, addresses, deposit/withdraw history
Cards20Full card lifecycle + 5 transaction query types
Card Holders6KYC holder management (B2B/B2C)
Webhooks1Event callback receiver
Total46

​
Authentication

All requests require standard FinHub authentication headers:
HeaderRequiredDescription
X-Tenant-IDYesTenant identifier
AuthorizationYesBearer JWT token
Content-TypeYesapplication/json

​
Environments

EnvironmentBase URL
Sandboxhttps://sandbox.finhub.cloud/api/v2.1/fincard/virtual
Integrationhttps://api-beta.finhub.cloud/api/v2.1/fincard/virtual
Productionhttps://api.finhub.cloud/api/v2.1/fincard/virtual