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/loadandPOST/v1/cards/:id/unloadwithamountin 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/:idshows 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.
paygent