Virtual Cards – API Endpoint Reference
action | method & endpoint | description |
|---|---|---|
Create Card | POST /api/cards | Issues a new virtual or physical card for a customer. |
Get Card | GET /api/cards/:cardId | Retrieves general card information including balance and status. |
Get Card Details | GET /api/cards/:cardId/details | Retrieves sensitive card details including full card number, expiry, and CVV. |
List Cards | GET /api/cards | Retrieves a paginated list of all cards under your company. |
Fund Card | POST /api/cards/:cardId/fund | Adds funds to a card's balance. |
Withdraw from Card | POST /api/cards/:cardId/withdraw | Removes funds from a card's balance back to your account. |
Freeze Card | POST /api/cards/:cardId/freeze | Temporarily suspends the card from transacting. |
Unfreeze Card | POST /api/cards/:cardId/unfreeze | Reactivates a previously frozen card. |
Terminate Card | POST /api/cards/:cardId/terminate | Permanently deactivates the card. Cannot be reversed. |
Update Spending Limits | PUT /api/cards/:cardId/spending-limits | Updates the spending limits on a card. |
Get Cards by Customer | GET /api/customers/:customerId/cards | Retrieves all cards belonging to a specific customer. |
Base URL for all endpoints: https://api.bitnob.com