Recharge API Integration

<?php
$params = array(
    'username'     => 'YOUR_USERNAME',
    'pwd'          => 'YOUR_PASSWORD',
    'circlecode'   => '0',            // circle code (list below); send 0 if you do not know it
    'operatorcode' => 'RC',           // RC = Jio, A = Airtel, V = Vodafone (list below)
    'number'       => '9800000000',
    'amount'       => '10',
    'orderid'      => 'ORD' . time(), // unique for every request
    'format'       => 'json',
);
$ch = curl_init('https://business.a1topup.com/recharge/api?' . http_build_query($params));
curl_setopt_array($ch, array(CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 60));
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

if ($res && $res['status'] === 'Success')     { /* mark order successful, save $res['opid'] */ }
elseif ($res && $res['status'] === 'Failure') { /* refund your customer */ }
else                                           { /* pending: wait for the callback or call the status API */ }

const params = new URLSearchParams({
  username: 'YOUR_USERNAME', pwd: 'YOUR_PASSWORD',
  circlecode: '0', operatorcode: 'RC', number: '9800000000',   // circlecode 0 = unknown
  amount: '10', orderid: 'ORD' + Date.now(), format: 'json'
});
const res = await fetch('https://business.a1topup.com/recharge/api?' + params);
const data = await res.json();   // { txid, status, opid, number, amount, orderid }
console.log(data.status);

import requests, time
params = {"username": "YOUR_USERNAME", "pwd": "YOUR_PASSWORD", "circlecode": "0",  # 0 = circle not known
          "operatorcode": "RC", "number": "9800000000", "amount": "10",
          "orderid": f"ORD{int(time.time())}", "format": "json"}
data = requests.get("https://business.a1topup.com/recharge/api", params=params, timeout=60).json()
print(data["status"], data.get("opid"))

curl "https://business.a1topup.com/recharge/api?username=YOUR_USERNAME&pwd=YOUR_PASSWORD&circlecode=0&operatorcode=RC&number=9800000000&amount=10&orderid=ORD1001&format=json"

# Test mode: same request, only the path changes from recharge/ to sandbox/
curl "https://business.a1topup.com/sandbox/api?username=YOUR_USERNAME&pwd=YOUR_PASSWORD&circlecode=0&operatorcode=RC&number=9876543218&amount=199&orderid=TEST1001&format=json"

// Status API (use the same order id you sent with the recharge)
https://business.a1topup.com/recharge/status?username=YOUR_USERNAME&pwd=YOUR_PASSWORD&orderid=ORD1001&format=json

// Balance API (replies with a plain number, e.g. 1542.50)
https://business.a1topup.com/recharge/balance?username=YOUR_USERNAME&pwd=YOUR_PASSWORD

<?php
// callback.php - A1Topup calls: https://yourdomain.com/callback.php?txid=ORDER_ID&status=Success&opid=OPERATOR_ID
$orderId = isset($_GET['txid'])   ? $_GET['txid']   : '';   // your order id
$status  = isset($_GET['status']) ? $_GET['status'] : '';   // Success or Failure
$test    = isset($_GET['sandbox']);                          // present only for test-mode callbacks
$opid    = isset($_GET['opid'])   ? $_GET['opid']   : '';   // operator reference
// 1. find the order by $orderId   2. update it only if it is still pending
// 3. if Failure: refund the customer's wallet   4. respond with HTTP 200
http_response_code(200); echo 'OK';