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 --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
}'

$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;

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

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

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

PreviousCreate Card Account NextCard Funding

Last updated 1 year ago

hashtagHeaders

hashtagRequest Body

hashtagSample response

Headers

Request Body

Sample response