Get Recharge

GET https://payonclick.in/ext/v1/recharge/transaction/{reference_id}

Any valid API key Counts toward your 60 req/min

One recharge and its current status

Query & Path Params

Name	Type	Description
reference_id required	path	From POST /recharge

Responses

Status	Description
200 OK	One recharge and its current status — see the example on the right.
200 OK · failed recharge	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

status is SUCCESS, PENDING or FAILED. This endpoint reads the stored state and never calls the operator. Operator callbacks update a recharge within seconds, and every PENDING recharge is re-checked every 2 minutes, so polling more often than every 30 seconds gains nothing. refunded: true on a FAILED recharge means the debit is back in your MAIN wallet, or was never taken.

failure_code (FAILED only) is stable and safe to branch on: INVALID_NUMBER (wrong number or operator), INVALID_AMOUNT (plan or denomination not accepted), DUPLICATE_RECHARGE (the same number and amount were recharged moments ago; wait before retrying), OPERATOR_UNAVAILABLE (the operator is down; retry later), INSUFFICIENT_BALANCE, NOT_SUBMITTED (never reached the operator) and OPERATOR_FAILED (any other operator decline). After a FAILED recharge a fresh attempt needs a new client_reference.

API_KEY="poc_live_your_key_here" TS=$(date +%s) curl -X GET 'https://payonclick.in/ext/v1/recharge/transaction/RCG2451789212345A1B2C3' \ -H "Authorization: Bearer $API_KEY" \ -H "X-Timestamp: $TS"

import hashlib, hmac, json, time, requests API_KEY = "poc_live_your_key_here" PATH = "/ext/v1/recharge/transaction/RCG2451789212345A1B2C3" 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=90) print(r.json())

<?php $apiKey = 'poc_live_your_key_here'; $path = '/ext/v1/recharge/transaction/RCG2451789212345A1B2C3'; $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_TIMEOUT => 90, 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/recharge/transaction/RCG2451789212345A1B2C3"; String body = ""; String ts = String.valueOf(System.currentTimeMillis() / 1000); HttpRequest.Builder req = HttpRequest.newBuilder(URI.create(HOST + path + "")) .timeout(java.time.Duration.ofSeconds(90)) .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": { "reference_id": "RCG2451789212345A1B2C3", "client_reference": "RC-2026-000123", "status": "SUCCESS", "service": "PREPAID", "operator_id": 2, "operator_name": "Jio", "number": "9876543210", "amount": 199.0, "total_debit": 199.0, "operator_ref": "BR000CXYZ12345", "message": "Recharge successful", "failure_code": null, "refunded": false, "created_at": "2026-09-12T11:25:45", "updated_at": "2026-09-12T11:25:48" } }

{ "success": true, "data": { "reference_id": "RCG2451789212399F0E1D2", "client_reference": "RC-2026-000124", "status": "FAILED", "service": "DTH", "operator_id": 104, "operator_name": "Tata Sky", "number": "1234567890", "amount": 350.0, "total_debit": 350.0, "operator_ref": null, "message": "The operator rejected this number. Check the number and the operator.", "failure_code": "INVALID_NUMBER", "refunded": true, "created_at": "2026-09-12T11:31:02", "updated_at": "2026-09-12T11:31:04" } }