Bill Fetch

POSThttps://xyz.com/v1/service/bbps/fetch-bill

Authentication

Basic Authentication

• Username: Client Id
• Password: Secret Key

Example Authorization Header:

Authorization: Basic eGV0dGxlXzgzMjg2NjU5YmRmNzBkZWEzMDUwMzcwNzE1MTYwMzA0MDo3YzE1ZDQyYTZhYjEyOTYzYWI4NzJhMzFkOTk4MDk1ZDMwNTAzNzA3MTUxNjMyMDg5

Request Body

{
 "operatorId":"21944",
 "customerMobileNumber":"7505332915",
 "number0":"JH05DS1301",
 "number1":"33"
}

Request Parameters

Parameter	Type	Required	Description
operatorId	String	Yes	Unique identifier for the operator
customerMobileNumber	String	Yes	Customer's mobile number
number0	String	Conditional	Primary account identifier (varies by operator)
number1	String	Conditional	Secondary account identifier (varies by operator)

Request Examples

Request Examples

Curl

curl --location 'https://xyz.com/v1/service/bbps/fetch-bill' --header 'Content-Type: application/json' --header 'Authorization: Basic eGV0dGxlXzU1NDlhYmQwYzJmNjdiOGUyMjM4Mjg5MTExMDc3MTExMjpjYjYyNzZlZTUwNGE1NzUzNDJlOTRlNmIwZjQ4MmQ0MTIyMzgyODkxMTEwNzc3NjM2' --data '{
 "operatorId":"21944",
 "customerMobileNumber":"7505332915",
 "number0":"JH05DS1301",
"number1":"33"
}'

JavaScript

const axios = require('axios');
let data = JSON.stringify({
  "operatorId": "21944",
  "customerMobileNumber": "7505332915",
  "number0": "JH05DS1301",
  "number1": "33"
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://xyz.com/v1/service/bbps/fetch-bill',
  headers: { 
    'Content-Type': 'application/json', 
    'Authorization': 'Basic eGV0dGxlXzU1NDlhYmQwYzJmNjdiOGUyMjM4Mjg5MTExMDc3MTExMjpjYjYyNzZlZTUwNGE1NzUzNDJlOTRlNmIwZjQ4MmQ0MTIyMzgyODkxMTEwNzc3NjM2'
  },
  data : data
};

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

C#

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://xyz.com/v1/service/bbps/fetch-bill");
request.Headers.Add("Authorization", "Basic eGV0dGxlXzU1NDlhYmQwYzJmNjdiOGUyMjM4Mjg5MTExMDc3MTExMjpjYjYyNzZlZTUwNGE1NzUzNDJlOTRlNmIwZjQ4MmQ0MTIyMzgyODkxMTEwNzc3NjM2");
var content = new StringContent("{
 "operatorId":"21944",
 "customerMobileNumber":"7505332915",
 "number0":"JH05DS1301",
"number1":"33"
}", null, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

Java

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{
 "operatorId":"21944",
 "customerMobileNumber":"7505332915",
 "number0":"JH05DS1301",
"number1":"33"
}");
Request request = new Request.Builder()
  .url("https://xyz.com/v1/service/bbps/fetch-bill")
  .method("POST", body)
  .addHeader("Content-Type", "application/json")
  .addHeader("Authorization", "Basic eGV0dGxlXzU1NDlhYmQwYzJmNjdiOGUyMjM4Mjg5MTExMDc3MTExMjpjYjYyNzZlZTUwNGE1NzUzNDJlOTRlNmIwZjQ4MmQ0MTIyMzgyODkxMTEwNzc3NjM2")
  .build();
Response response = client.newCall(request).execute();

Python

import requests
import json

url = "https://xyz.com/v1/service/bbps/fetch-bill"

payload = json.dumps({
  "operatorId": "21944",
  "customerMobileNumber": "7505332915",
  "number0": "JH05DS1301",
  "number1": "33"
})
headers = {
  'Content-Type': 'application/json',
  'Authorization': 'Basic eGV0dGxlXzU1NDlhYmQwYzJmNjdiOGUyMjM4Mjg5MTExMDc3MTExMjpjYjYyNzZlZTUwNGE1NzUzNDJlOTRlNmIwZjQ4MmQ0MTIyMzgyODkxMTEwNzc3NjM2'
}

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

print(response.text)

Response Examples

Success

{
    "code": "0x0200",
    "message": "000: Operators Fetch Successfully.",
    "status": "SUCCESS",
    "data": {
        "requestId": "R93DFS0FZQ9XMKEA5V3TR5U1LDCHH4PBU8S",
        "customerName": "Sushil Kumar Mishra",
        "billDueDate": null,
        "billAmount": 500,
        "billDetails": ""{\"responseCode\":\"000\",\"inputParams\":{\"input\":[{\"paramName\":\"Vehicle Number\",\"paramValue\":\"JH05DS1301\"}]},\"billerResponse\":{\"billAmount\":\"50000\",\"billNumber\":\"1746258537757\",\"customerName\":\"Sushil Kumar Mishra\"},\"additionalInfo\":{\"info\":[{\"infoName\":\"Fast Tag Balance\",\"infoValue\":\"5175.88\"},{\"infoName\":\"Vehicle Model\",\"infoValue\":\"Xuv 700\"},{\"infoName\":\"Tag Status\",\"infoValue\":\"Active\"},{\"infoName\":\"Maximum Permissible Recharge Amount\",\"infoValue\":\"10000.0\"},{\"infoName\":\"Minimum Amount for Top-up\",\"infoValue\":\"500.0\"}]}}""
    }
}

Failed

{
    "code": "0x0201",
    "message": "Unauthorized IP used.",
    "status": "FAILURE",
    "ip": "152.58.32.60"
}

MISSING_PARAMETER

{
    "code": "0x0203",
    "status": "MISSING_PARAMETER",
    "message": "contactId is not valid"
}

Response Codes

The API uses the following response codes to indicate the status of requests:

Code	Description	Meaning
0x0200	SUCCESS	The request was processed successfully.
0x0201	UNAUTHORIZED	Authentication failed or insufficient permissions.
0x0202	FAILED	The request processing failed for a reason other than those specifically identified.
0x0203	MISSING_PARAMETER	The request is missing one or more required parameters.
0x0206	PENDING	The request has been received and is being processed, but processing has not yet completed.
0x0205	SOMETHING_WENT_WRONG	A server error occurred during processing of the request.