Status Enquiry

Post  https://api.bos.center/api/BOS/RechargesStatus


Use this API to authenticate with the BOS system and obtain the authorization bearer token. All other API calls must have this token as Authorization header in the format 'Bearer' (without quotes) for them to get processed. The generated token is valid for 600 seconds.

Click to view the steps to generate a public key and the signature.

Body Parameters
{
  "registrationID": "BOS-554",
  "referenceid": "1234"
}
                        
Responses

200

200

Response

200

RESPONSE BODY

object

responsecode    integer

status    boolean

message    string

401

401

Response

401

RESPONSE BODY

object

response_code     integer

status     boolean

message     string


Did this page help you?     Yes    No

Language
shell Shell
python Python
node Node
c# C#
php PHP

cURL

curl --location 'https://api.bos.center/api/BOS/RechargesStatus' \
--header 'Content-Type: application/json' \
--data  '{
  "RegistrationID": "BOS-554",
  "ReferenceId": "1234"
}'
                                
import requests
import json

url = 'https://api.bos.center/api/BOS/RechargesStatus'
payload = json.dumps({
  "RegistrationID": "BOS-554",
  "ReferenceId": "1234"
}) 

headers = {
  "Content-type" : "application/json"
}

response = requests.request("POST", url, headers=headers, data=payload)

print (response.text)
                                
var requests = require("request");
var options = { 
  "method" : "POST",
  "url" : 'https://api.bos.center/api/BOS/RechargesStatus',
  "headers" : {
    "Content-Type" : 'application/json'
  },
  body: JSON.stringify({
    "RegistrationID": "BOS-554",
    "ReferenceId": "1234"
  }) 
}; 
request(options, function(error, response){
   if(error) throw new Error(error);
   console.log(response.body); 
}); 
                                
var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post,'https://api.bos.center/api/BOS/RechargesStatus')
var content = new StringContent(
  "{
    "RegistrationID": "BOS-554",
    "ReferenceId": "1234"
  }",
  null,"application/json"
); 

request.Content = content;
var response =  await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
                                
<?php
$curl =  curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL =>  'https://api.bos.center/api/BOS/RechargesStatus',
  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 =>  '{
    "RegistrationID": "BOS-554",
    "ReferenceId": "1234"
  }',
  CURLOPT_HTTPHEADER =>  array(
    'Content-Type: application/json'
  ),
));
$response =  curl_exec($curl);
curl_close($curl);
echo $response;
                                

RESPONSE

200

401

-Result

Example

{
  "responsecode": 1,
  "status": true,
  "data": {
    "txnid": "79394",
    "operatorname": "Airtel",
    "canumber": "9971355854",
    "amount": "10",
    "comm": "0.02",
    "tds": "0.00",
    "status": "1",
    "refid": "6734567895",
    "operatorid": "DUMMYOPERATOR ID",
    dateadded": "2023-06-13 13:30:22",
    "refunded": "0",
    "refundtxnid": "",
    "daterefunded": null
  },
  "message": "Transaction Enquiry Successful"
}
                                
 
{
  "response_code": 7,
  "status": false,
  "message": "Authentication failed."
}