1app
Create Boldd AccountLogin
  • Introduction
  • Authentication
  • Balance
  • Get Exchange Rate
  • Response Code
  • RECEIVE PAYMENTS
    • Payments
      • Initialize Payment
      • Verify Payment
      • Payment List
      • Payment Details
    • Inline/Popup Checkout
    • Payouts / Settlements
      • Payouts List
      • Settlement Transactions
    • Dispute Management
      • Fetch Disputes
      • Accept a Dispute
      • Decline a Dispute
    • Customers List
    • Webhook Notifications
    • Repush Notification
  • Virtual Accounts
    • Get Available Banks
    • Setup Preferred Bank
    • Generate Account
    • Virtual Account List
    • Account Transactions
    • Virtual Account Webhook
      • Notifications history
  • MAKE PAYMENTS
    • Airtime Purchase
    • Send Money
      • Verify Account Number
      • Make Transfer
    • Data Purchase
      • Data Plans
      • Data Bundle
    • Electricity
      • Electricity Billers
      • Verify Meter Number
      • Vend Electricity
    • Cable TV
      • Cable TV List
      • Verify IUC
      • Vend CableTv
    • Bank List
    • Payment Status
  • CUSTOMERS
    • Create Customer
  • VIRTUAL CARDS
    • Create Card Account
    • Cards Issuance
    • Card Funding
    • Card Transactions
    • Get all Cards
    • Cards Details
    • Cards Pan
    • Freeze and Unfreeze Card
  • USD Account
    • Create USD Account
  • IDENTITY
    • BVN Check
    • NIN Checks
  • SUB-ACCOUNTS
    • Create a Sub-Account
    • Attach Bank to a Sub-Account
    • Attach Payout Account
    • Get All Sub-Accounts
    • Sub-Accounts History
    • Sub-Accounts Wallet
  • Miscellaneous
    • Create Wallet
    • Universal Blacklist
  • Contact
    • Contact Us
Powered by GitBook
On this page

Was this helpful?

  1. VIRTUAL CARDS

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
}'
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);
});
$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"
}
{
    "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

PreviousCreate Card AccountNextCard Funding

Last updated 7 months ago

Was this helpful?

Page cover image