Virtual cards

USD Virtual Cards

Creating Virtual Card

The Bitnob virtual cards API allows you to offer Virtual Mastercard and Visa USD in a flexible way, with additional capabilities such as getting real-time card payment details, issuing cards on the fly, freezing/unfreezing cards and setting spending limits.

To create a card, a user has to be registered as a card user on our card section; this requires basic KYC details of your users.


Card Issuing

There are some onboarding steps that need to be completed before you can issue cards. Access to this API has to be pre-approved. Contact us at [email protected] requesting API access to cards if you need access to this API.

After successful registration of a card user, a card is created by sending the user's email is sent to the create_card endpoint.

Top Up Card

Business wallets are not attached to users' cards. To attached or add money to a card, a top-up transaction will be made from the business USD wallet to the user card.


Withdrawals is the only internal debit on a card. When withdrawals are made on a card, the amount withdrawn is been sent to the business' USD wallet.


Card Withdrawals Not Possible on Visa Cards

Withdrawals are only possible for MasterCards. Our Visa Cards currently don't allow withdrawals

Freeze Card

Cards can be frozen(i.e. deactivated) to pause new transactions, primarily for security issues or financial purposes. Freezing of a card will pause all transactions except withdrawal.

Unfreeze Card

Unfreezing a card to resume transactions on a frozen card is also possible.


Time Restriction

Freeze and Unfreeze actions have 24-hour time restrictions. That is they are only effective after 24 hours.

  • Freezing and unfreezing a card can also be done on the dashboard.

Freeze and Unfreeze Card


Card Freeze and Unfreeze Not Possible on Visa Cards

Freezing and Unfreezing are only possible for MasterCards. Our Visa Cards currently don't allow these actions.

Card Transactions

Card Transactions include top-up, withdrawal and debits actions performed with users' cards. Businesses can view transactions via the API or on the dashboard:


Card Transactions


Card Transactions Not Possible on Visa Cards

Seeing Card Transactions are only possible for MasterCards. Our Visa Cards currently don't allow card transactions. To get the current balance of a card, A get query has to be made with the card_id.

Webhook Events

A virtualcard.transaction.debit event for every debit transaction done on a card.
In a case for reversals, a reverse event virtualcard.transaction.reversed is also sent to your Webhook URL.

Webhook events should be verified and tested before production. Bitnob's Webhook can be tested following this setup.


Wehbooks only work for MasterCard

Webhooks are only sent for MasterCard transactions.

Visa vs MasterCard

We currently offer both MasterCard and Visa Cards. Our Visa Cards are gifts card which has several restrictions. Here are the key differences between both cards to help you choose what service to offer if you don't want to offer both;



Visa Gift Card

Top Up




Did this page help you?