To create a card, a user has to be registered as a card user in our card section; this requires basic KYC details of your users.
We support all countries and have different IDType for certain countries; here is the list;
| Countries | Accepted Documents |
|---|---|
| Nigeria | [vNIN, PASSPORT, DRIVERS_LICENSE, PVC] |
| Ghana | [PASSPORT, DRIVERS_LICENSE, VOTERS_ID] |
| Kenya | [PASSPORT, NATIONAL_ID] |
| Senegal | [NATIONAL_ID, ECOWAS_ID] |
| Other Countries | [NATIONAL_ID] |
This endpoint is used to create a new card.
POST {{base_url}}/api/v1/customer/virtual/cards/create
amount (number, required): The amount to be funded with the new card.{
"amount": 500, // in multiple of 100s. [500 == $5]
"customer_id": "xxxxxxxxx-xxxx-xxxxx-xxxxxxxxx"
}
The response will contain the details of the newly created card.
Make a GET request to {{base_url}}/api/v1/customer/virtual/cards/list
Make a GET request to {{base_url}}/api/v1/customer/virtual/cards/get/{{virtual_card_id}}
To freeze and unfreeze a card make a PUT request to
{{base_url}}/api/v1/customer/virtual/cards/update/{{virtual_card_id}}
with the payload
{
"action": "freeze" // unfreeze
}