Virtual Cards Issuance

This endpoint is used to issue a new card for a customer after creating card account for the user using the create card account endpoint.

POST {{base_url}}/business/vcard-issuance

Headers

Name	Type	Description
Authorization*	String	SECRET_KEY

Request Body

Name	Type	Description
cardbrand*	Sting	Card brand you want to issued e.g Mastercard, Visa
currency*	String	USD for USD Virtual Card or NGN for NGN Virtual card
amount*		Amount to pre-fund the card with after issuing
trackingid*	String	Customer tracking ID returned from the card account endpoint

Your secret keys are to be kept secret and only stored on your servers. Do not pass your secret key to the front-end language where it can be exploited.

Take a look at how you might do this:

cURL

curl --location '{{base_url}}/business/vcard-issuance' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer SECRET_KEY' \
--data '{
    "currency": "USD",
    "trackingid": "9239293",
    "cardbrand": "Mastercard",
    "amount": 5
}'

NodeJs

const axios = require('axios');
let data = JSON.stringify({
  "currency": "USD",
  "trackingid": "9239293",
  "cardbrand": "Mastercard",
  "amount": 5
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: '{{base_url}}/business/vcard-issuance'
  headers: { 
    'Content-Type': 'application/json', 
    'Authorization': 'Bearer SECRET_KEY'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

PHP - cURL

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => '{{base_url}}/business/vcard-issuance',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "currency": "USD",
    "trackingid": "9239293",
    "cardbrand": "Mastercard",
    "amount": 5
}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'Authorization: Bearer SECRET_KEY'
  ),
));

$response = curl_exec($curl);
curl_close($curl);
echo $response;

Dart

var headers = {
  'Content-Type': 'application/json',
  'Authorization': 'Bearer SECRET_KEY'
};
var request = http.Request('POST', Uri.parse('{{base_url}}/business/vcard-issuance'));
request.body = json.encode({
  "currency": "USD",
  "trackingid": "9239293",
  "cardbrand": "Mastercard",
  "amount": 5
});
request.headers.addAll(headers);

http.StreamedResponse response = await request.send();

if (response.statusCode == 200) {
  print(await response.stream.bytesToString());
}
else {
  print(response.reasonPhrase);
}

Sample response

Successful

{
    "status": true,
    "responsecode": "01",
    "message": "Card Issuance Processing",
    "txref": "0621121102020",
    "charged": 6,
    "currency": "USD"
}

Failed

{
    "status": false
    "responsecode": "00",
    "message": "Insufficient wallet balance for this transaction",
    "txref": "",
    "charged": ""
}

When the card is successfully processed, we will notify you via webhook notification with the card details and card ID. Event_type as transactions and Paid_through as virtualcard