Products

Virtual cards

Issue US dollar virtual cards, loaded from your naira balance.

USD virtual cards is switched on by request. Ask from Settings › Products and access; once approved it works in test and live mode. Until then the API answers 403 with the code shown below.

1. A cardholder

POST/v1/cardholders with first_name, last_name, email, phone, date_of_birth, bvn, id_type (nin, passport, drivers_license, voters_card), id_number, id_image (base64) and address (street, city, state, zip_code). Our partner checks them; we keep only the name, contact details and the BVN's last four.

2. A card

POST/v1/cards with cardholder, amount (the first load, in cents: at least 300, $3), and optionally label and max_total (the most naira you accept, with fees).

Loading, emptying, freezing

  • POST/v1/cards/:id/load and POST/v1/cards/:id/unload with amount in cents. Loads are paid in naira at the current rate; unloads come back in naira.
  • POST/v1/cards/:id/freeze, POST/v1/cards/:id/unfreeze.
  • GET/v1/cards/:id shows the balance, loads and spends.

The card number is never sent through the API. Owners and admins can see it on the dashboard with their authenticator code. Not switched on: 403 card_type_not_enabled.