Get Biller Details

GET https://payonclick.in/ext/v1/bbps/biller/{biller_id}

Any valid API key Counts toward your 60 req/min

The exact input fields this biller requires

Query & Path Params

Name	Type	Description
biller_id required	path	Biller id from /billers

Responses

Status	Description
200 OK	The exact input fields this biller requires — see the example on the right.
200 OK · ad-hoc biller	Alternate outcome for the same call — the second Response tab.
4xx / 5xx	`{ "success": false, "error": { "code": "…", "message": "…" } }` — every code is listed under Error Codes.

📘

Good to know

Never skip this call. Every biller names its fields differently — Adani wants a 9-digit Consumer number, AVVNL a 12-digit K Number. Echo each param_name verbatim into /bill/fetch, or Bharat Connect returns E135. The adhoc flag decides the whole downstream flow.

import hashlib, hmac, json, time, requests API_KEY = "poc_live_your_key_here" PATH = "/ext/v1/bbps/biller/{biller_id}" BODY = b"" ts = str(int(time.time())) r = requests.request( "GET", "https://payonclick.in" + PATH, headers={ "Authorization": f"Bearer {API_KEY}", "X-Timestamp": ts, }, timeout=60) print(r.json())

<?php $apiKey = 'poc_live_your_key_here'; $path = '/ext/v1/bbps/biller/{biller_id}'; $body = ''; $ts = (string) time(); $headers = [ "Authorization: Bearer {$apiKey}", "X-Timestamp: {$ts}", ]; $ch = curl_init('https://payonclick.in' . $path); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'GET', CURLOPT_HTTPHEADER => $headers, ]); echo curl_exec($ch);

import java.net.URI; import java.net.http.*; import java.nio.charset.StandardCharsets; public class PayonclickExample { static final String HOST = "https://payonclick.in"; static final String API_KEY = "poc_live_your_key_here"; public static void main(String[] args) throws Exception { String path = "/ext/v1/bbps/biller/{biller_id}"; String body = ""; String ts = String.valueOf(System.currentTimeMillis() / 1000); HttpRequest.Builder req = HttpRequest.newBuilder(URI.create(HOST + path)) .header("Authorization", "Bearer " + API_KEY) .header("X-Timestamp", ts); req.method("GET", HttpRequest.BodyPublishers.noBody()); HttpResponse<String> res = HttpClient.newHttpClient() .send(req.build(), HttpResponse.BodyHandlers.ofString()); System.out.println(res.body()); } }

{ "success": true, "data": { "biller_id": "RELI00000MUM03", "biller_name": "Adani Electricity Mumbai Limited", "category": "Electricity", "category_slug": "electricity", "adhoc": false, "fetch_requirement": "MANDATORY", "payment_exactness": "Exact", "payment_channel": "AGT", "payment_mode": "Cash", "supports_agent_channel": true, "is_available": true, "unavailable_reason": null, "input_params": [ { "param_name": "Consumer number", "data_type": "NUMERIC", "is_optional": false, "min_length": 9, "max_length": 9, "allowed_values": [] } ] } }

{ "success": true, "data": { "biller_id": "TATASKY00NAT01", "biller_name": "TATA Play", "category_slug": "dth", "adhoc": true, "fetch_requirement": "NOT_SUPPORTED", "payment_channel": "AGT", "is_available": true, "input_params": [ { "param_name": "Mobile Number", "data_type": "NUMERIC", "is_optional": true, "min_length": 10, "max_length": 10 }, { "param_name": "Subscriber Number", "data_type": "NUMERIC", "is_optional": true, "min_length": 10, "max_length": 10 } ] } }