Virtual Cards – API Endpoint Reference
| Action | Method & Endpoint | Description |
|---|---|---|
| Register Card User | POST /api/v1/virtualcards/registercarduser | Registers a new virtual card user in the system. Required before card creation. |
| Create Card | POST /api/v1/virtualcards/createcard | Issues a new virtual Visa card for a registered user. |
| Top Up Card | POST /api/v1/virtualcards/topup | Adds funds to a virtual card from your wallet/float. |
| List Cards (User) | GET /api/v1/virtualcards/cards | Retrieves all virtual cards linked to a user. |
| List Card Users | GET /api/v1/virtualcards/users | Retrieves a list of all registered virtual card users. |
| Fetch Card User | GET /api/v1/virtualcards/users/{card_user_id} | Gets details for a specific registered card user. |
| Fetch Card | GET /api/v1/virtualcards/cards/{cardId} | Retrieves card details using the card ID. |
| List Transactions on Card | GET /api/v1/virtualcards/transactions/{cardId} | Retrieves all transactions for a specific virtual card. |
| List All Card Transactions | GET /api/v1/virtualcards/cards/transactions | Retrieves transactions across multiple virtual cards. |
| Withdraw from Card | POST /api/v1/virtualcards/withdraw | Initiates a withdrawal from a card (if enabled). |
| Freeze Card | POST /api/v1/virtualcards/freeze | Temporarily suspends the card from transacting. |
| Unfreeze Card | POST /api/v1/virtualcards/unfreeze | Reactivates a previously frozen card. |
| Terminate Card | POST /api/v1/virtualcards/terminate | Permanently deactivates the card. Cannot be reversed. |
Base URL for all endpoints: https://sandboxapi.bitnob.co
