Card Transactions

This endpoint returns all the transactions for a specific card

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

Headers

Name	Type	Description
Authorization*	String	SECRET_KEY

Request Body

Name	Type	Description
vcardid*	Sting	virtual card ID

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-trans' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer SECRET_KEY' \
--data '{
    "vcardid": "ao022-22e23o-2238-2829d"
}'

NodeJs

const axios = require('axios');
let data = JSON.stringify({
  "vcardid": "ao022-22e23o-2238-2829d"
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: '{{base_url}}/business/vcard-trans'
  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-trans',
  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 =>'{
    "vcardid": "ao022-22e23o-2238-2829d"
}',
  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-trans'));
request.body = json.encode({
  "vcardid": "ao022-22e23o-2238-2829d"
});
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,
  "msg": "Transaction Retrieved",
  "data": [
    {
      "card_type": "virtual",
      "card_brand": "Mastercard",
      "card_currency": "USD",
      "maskedPan": "501300********1234",
      "amount": 38,
      "fee": "0",
      "trans_currency": "USD",
      "merchantAmount": 3,
      "merchantCurrency": "USD",
      "merchant_name": "Facebook. Sub",
      "merchant_city": "6007100 MA",
      "description": "Approved or completed successfully",
      "transchannel": "Meta AuthCode - DULRD8",
      "transtype": "Settlement",
      "transtatus": "1",
      "trans_reference": 18050757,
      "timed": 1736204253,
      "transdate": "2024-11-08T03:44:13"
    },
    {
      "card_type": "virtual",
      "card_brand": "Mastercard",
      "card_currency": "USD",
      "maskedPan": "501300********1234",
      "amount": 40,
      "fee": "0",
      "trans_currency": "USD",
      "merchantAmount": 0,
      "merchantCurrency": null,
      "merchant_name": "1app Technologies",
      "merchant_city": "Lekki",
      "description": "Card Funding of 40",
      "transchannel": "1app Technologies AuthCode - 278236827",
      "transtype": "CardFunding",
      "transtatus": "1",
      "trans_reference": 0,
      "timed": 1736204253,
      "transdate": "2024-11-07T14:48:17"
    }
  ]
}