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

Work Orders

Work order management and submission

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

Group	Endpoints	Description
Common	7	Reference data, file upload, work orders
Accounts	8	Account CRUD, balances, ledger, transfers
Crypto Wallet	4	Coins, addresses, deposit/withdraw history
Cards	21	Full card lifecycle + 5 transaction query types
Card Holders	6	KYC holder management (B2B/B2C)
Webhooks	1	Event callback receiver
Work Orders	2	Work order management
Total	49

Authentication

All requests require standard FinHub authentication headers:

Header	Required	Description
`X-Tenant-ID`	Yes	Tenant identifier
`Authorization`	Yes	Bearer JWT token
`Content-Type`	Yes	`application/json`

Environments

Environment	Base URL
Sandbox	`https://sandbox.finhub.cloud/api/v2.1/fincard/virtual`
Integration	`https://api-beta.finhub.cloud/api/v2.1/fincard/virtual`
Production	`https://api.finhub.cloud/api/v2.1/fincard/virtual`

Connectors

PaaS Journey

PaaS Operations

FinCard Virtual

FinCard Virtual

FinCard Virtual

API Groups

Common

Accounts

Crypto Wallet

Cards

Card Holders

Webhooks

Work Orders

Card Issuance Flows

Issuance Processes

Quick Start: Issue a Virtual Card

Step 1: Get Available Card Types

Step 2: Create Cardholder (if required)

Step 3: Create Card

Step 4: Query Card Info

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

Endpoint Summary

Authentication

Environments

​FinCard Virtual

​API Groups

Common

Accounts

Crypto Wallet

Cards

Card Holders

Webhooks

Work Orders

​Card Issuance Flows

Issuance Processes

​Quick Start: Issue a Virtual Card

​Step 1: Get Available Card Types

​Step 2: Create Cardholder (if required)

​Step 3: Create Card

​Step 4: Query Card Info

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

​Endpoint Summary

​Authentication

​Environments

FinCard Virtual

API Groups

Card Issuance Flows

Quick Start: Issue a Virtual Card

Step 1: Get Available Card Types

Step 2: Create Cardholder (if required)

Step 3: Create Card

Step 4: Query Card Info

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

Endpoint Summary

Authentication

Environments