FinCard Virtual

Virtual card issuance, management, and crypto wallet integration

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