Nepal Recharge APIs Docs Welcome

Welcome

Welcome to the Nepal Recharge for developer's and vendor's!

Out of the box, Nepal Recharge has elegant APIs for every operator of Nepal and India. It is time to start building amazing applications and stop wasting time searching for packages and reinventing the wheel.

Next-Gen Architecture

Everything you need to be amazing

Enterprise grade telecom and utility transaction rails with automatic fallback routing, sub-500ms processing, database session locks, and authoritative pricing.

Download PDF Download Postman Get API Credentials

Easy Integration

Nepal Recharge APIs are designed to be simple to use, efficient, and secure. Standard REST payloads with comprehensive cURL and SDK snippets.

Elaborative Documentation

Documentation is the most important part of any API. We have made it easy to understand, test, and implement across all telecom operators.

Code Faster

Code faster with Nepal Recharge APIs for Nepali and Indian Operators. Quickly build out your application, and get back to what really matters.

Highly secure and Easy Integrations

Our robust infrastructure ensures a highly secure environment, while user-friendly interfaces make integration a breeze. Elevate your application performance with our API solutions that prioritize both security and simplicity.

Experience seamless integration with our APIs, combining unparalleled security measures with effortless implementation.

Next API Reference Guide

Last updated: September 2026 Version 1.2.0

Nepal Recharge Mobile Ncell

Ncell

You can get the list of available operators from the Operator lookup API and available operator types from the Operator Type Lookup API.

Ncell Number Starts With 980 , 981 , 982 , 970 , 971

Test Number : Any number starting with above & must be 10 digits only. e.g. 9801037488

How To Use:

Identify the Operator:
First, use the Operator Lookup API to get the correct operator based on user input or selection (operator_id = 1).
Determine Operator Type:
Use the Operator Type Lookup API to confirm the type (operator_type_id = 1 for Mobile).
Initiate Recharge:
Once you have obtained all the required details, submit the recharge execute request with the parameters given below.

Execute the recharge for Ncell

POST /api/v1/np/recharge/execute

Headers

Name	Value
x-auth-token	<token>
Content-Type	application/json
Accept	application/json

Body

Name	Type	Description
operator_id	number	The ID of the operator for the recharge (`1` for Ncell).
operator_type_id	number	The type ID of the operator (`1` for Mobile).
connection_no	string	The 10-digit connection number for which the recharge is to be executed.
reference_no	string	The unique reference number for the recharge transaction.
amount	number	Amount for which recharge has to be done (NPR 10.00 – NPR 5,000.00).

Request Example

POST /api/v1/np/recharge/execute

curl -X POST "https://nepalrecharge.com/api/v1/np/recharge/execute" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "x-auth-token: npr_live_YOUR_API_KEY" \
  -d '{
    "operator_id": 1,
    "operator_type_id": 1,
    "connection_no": "9801037488",
    "reference_no": "REF-NCELL-1001",
    "amount": 50
  }'

<?php
$curl = curl_init();

$data = json_encode([
    'operator_id'      => 1,
    'operator_type_id' => 1,
    'connection_no'    => '9801037488',
    'reference_no'     => 'REF-NCELL-1001',
    'amount'           => 50
]);

curl_setopt_array($curl, [
    CURLOPT_URL            => 'https://nepalrecharge.com/api/v1/np/recharge/execute',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_POSTFIELDS     => $data,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Accept: application/json',
        'x-auth-token: npr_live_YOUR_API_KEY'
    ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

<?php
use GuzzleHttp\\Client;

$client = new Client([
    'base_uri' => 'https://nepalrecharge.com/api/v1/',
    'timeout'  => 30.0,
]);

$response = $client->post('np/recharge/execute', [
    'headers' => [
        'Content-Type' => 'application/json',
        'Accept'       => 'application/json',
        'x-auth-token' => 'npr_live_YOUR_API_KEY',
    ],
    'json' => [
        'operator_id'      => 1,
        'operator_type_id' => 1,
        'connection_no'    => '9801037488',
        'reference_no'     => 'REF-NCELL-' . time(),
        'amount'           => 50,
    ],
]);

$result = json_decode($response->getBody()->getContents(), true);
print_r($result);

const axios = require('axios');

const payload = {
  operator_id: 1,
  operator_type_id: 1,
  connection_no: '9801037488',
  reference_no: 'REF-NCELL-1001',
  amount: 50
};

axios.post('https://nepalrecharge.com/api/v1/np/recharge/execute', payload, {
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
    'x-auth-token': 'npr_live_YOUR_API_KEY'
  }
}).then(res => console.log(res.data))
  .catch(err => console.error(err.response ? err.response.data : err));

import requests

url = "https://nepalrecharge.com/api/v1/np/recharge/execute"
headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "x-auth-token": "npr_live_YOUR_API_KEY"
}
payload = {
    "operator_id": 1,
    "operator_type_id": 1,
    "connection_no": "9801037488",
    "reference_no": "REF-NCELL-1001",
    "amount": 50
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Response

200 OK

JSON Success

{
  "error": false,
  "message": "Recharge executed successfully",
  "data": {
    "transaction_id": 156285850,
    "reference_no": "REF-NCELL-1001",
    "amount": 50.00,
    "credit_consumed": {
      "service_charge": 0.00,
      "instant_discount": 1.25,
      "debit_amount": 48.75
    },
    "credit_available": 8313.58,
    "status": "success"
  }
}

Previous Welcome

Next NTC (Namaste)

Nepal Recharge Mobile NTC (Namaste)

Nepal Telecom (Namaste)

Nepal Telecom – NTC (Namaste)

Real-time airtime top-up and balance refill for Nepal Telecom subscribers across Prepaid (Namaste Airtime), Postpaid, and CDMA/SKY services.

NTC Operator Sub-Groups & Prefixes

Nepal Telecom numbers are divided into 3 distinct operator IDs. Use the correct operator_id based on the number prefix:

NTC Prepaid operator_id: 5

NTC Airtime (Prepaid)

Starts with:

984 986 976 9040

Test: 9841037488

NTC Postpaid operator_id: 6

Namaste Postpaid Bill Payment

Starts with:

985

Test: 9851037488

NTC CDMA / SKY operator_id: 14

CDMA & Sky Phone Mobile

Starts with:

974 975

Test: 9741037488

How To Use:

Identify the Operator:
Select the operator based on the subscriber's phone number: 5 for Prepaid, 6 for Postpaid, or 14 for CDMA.
Determine Operator Type:
Always set operator_type_id = 1 (Mobile).
Set Valid Amount:
Minimum amount is NPR 10.00 and maximum is NPR 5,000.00 per single recharge request.
Initiate Recharge:
Submit the recharge execution request to /api/v1/np/recharge/execute with the required parameters below.

Execute Recharge for NTC (Namaste)

POST /api/v1/np/recharge/execute

Request Headers

Field	Type	Status	Description
x-auth-token	string	required	<token>
Content-Type	string	required	application/json
Accept	string	required	application/json

Request Body Parameters

Field	Type	Status	Description
operator_id	number	required	Numeric ID of the NTC operator: `5` for NTC Prepaid, `6` for NTC Postpaid, `14` for NTC CDMA/SKY.
operator_type_id	number	required	The type ID of the operator. Must be `1` for Mobile.
connection_no	string	required	The 10-digit NTC mobile connection number (e.g. `9841037488` or `9851037488`).
reference_no	string	required	Strictly unique client reference string generated by vendor system for transaction idempotency.
amount	number	required	Recharge amount in NPR (NPR 10.00 – NPR 5,000.00).

Code Examples

POST /api/v1/np/recharge/execute

curl -X POST "https://nepalrecharge.com/api/v1/np/recharge/execute" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "x-auth-token: npr_live_YOUR_API_KEY" \
  -d '{
    "operator_id": 5,
    "operator_type_id": 1,
    "connection_no": "9841037488",
    "reference_no": "ORD-NTC-1001",
    "amount": 100
  }'

<?php
$curl = curl_init();

$payload = json_encode([
    'operator_id'      => 5,
    'operator_type_id' => 1,
    'connection_no'    => '9841037488',
    'reference_no'     => 'ORD-NTC-' . time(),
    'amount'           => 100
]);

curl_setopt_array($curl, [
    CURLOPT_URL            => 'https://nepalrecharge.com/api/v1/np/recharge/execute',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Accept: application/json',
        'x-auth-token: npr_live_YOUR_API_KEY'
    ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

<?php
use GuzzleHttp\\Client;

$client = new Client([
    'base_uri' => 'https://nepalrecharge.com/api/v1/',
    'timeout'  => 30.0,
]);

$response = $client->post('np/recharge/execute', [
    'headers' => [
        'Content-Type' => 'application/json',
        'Accept'       => 'application/json',
        'x-auth-token' => 'npr_live_YOUR_API_KEY',
    ],
    'json' => [
        'operator_id'      => 5,
        'operator_type_id' => 1,
        'connection_no'    => '9841037488',
        'amount'           => 100,
        'reference_no'     => 'ORD-NTC-' . time(),
    ],
]);

$result = json_decode($response->getBody()->getContents(), true);
print_r($result);

const axios = require('axios');

const payload = {
  operator_id: 5,
  operator_type_id: 1,
  connection_no: '9841037488',
  reference_no: 'ORD-NTC-' + Date.now(),
  amount: 100
};

axios.post('https://nepalrecharge.com/api/v1/np/recharge/execute', payload, {
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
    'x-auth-token': 'npr_live_YOUR_API_KEY'
  }
}).then(res => console.log(res.data))
  .catch(err => console.error(err.response ? err.response.data : err));

import requests

url = "https://nepalrecharge.com/api/v1/np/recharge/execute"
headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "x-auth-token": "npr_live_YOUR_API_KEY"
}
payload = {
    "operator_id": 5,
    "operator_type_id": 1,
    "connection_no": "9841037488",
    "reference_no": "ORD-NTC-1001",
    "amount": 100
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Response Format

200 OK (Success Response)

{
  "error": false,
  "message": "Recharge executed successfully",
  "data": {
    "transaction_id": "TXN-NP-781923",
    "reference_no": "ORD-NTC-1001",
    "amount": 100.00,
    "credit_consumed": {
      "service_charge": 0.00,
      "instant_discount": 2.00,
      "debit_amount": 98.00
    },
    "credit_available": 12742.50,
    "commission": 2.00,
    "status": "success"
  }
}

Field	Type	Status	Description
transaction_id	string	always	Platform transaction identifier.
reference_no	string	always	Echoed vendor client reference number.
amount	number	always	Gross recharge amount credited to phone.
credit_consumed.debit_amount	number	always	Net balance deducted from master wallet.
status	string	always	`success`, `queued`, or `failed`.

Previous Ncell

Next DTH Recharge

Nepal Recharge DTH & Cable TV

Operator Type ID: 2 (DTH)

Nepal DTH & Cable TV Recharge

Real-time API integration for querying customer STB/CAS subscription accounts and executing immediate top-ups for all major Nepalese satellite and digital cable television providers.

Operator Type 2 (DTH)

STB Inquiry Supported

Package Fetch Live Plans

Settlement Instant & Realtime

Supported DTH & Cable Operators

Operator Lookup API →

Pass the respective operator_id along with operator_type_id = 2 in all DTH inquiries and execution requests:

Dish Home CAS ID / Smart Card No

ID: 36

SIM TV Smart Card / STB ID

ID: 37

Mero TV Subscriber Chip No

ID: 38

Sky TV Customer Account ID

ID: 39

Clear TV STB CAS ID (11 digits)

ID: 40

Prabhu TV STB / Smart Card ID

ID: 41

Jagriti Cable Customer Connection ID

ID: 42

Max TV Connection / STB No

ID: 43

Nijgadh Cable Subscriber Account No

ID: 58

Net TV User ID / Username

ID: 100

Png Network Customer Connection ID

ID: 112

Integration Workflow

1

Select Operator

Identify the DTH operator ID from the list above and set operator_type_id = 2.

2

Inquire Customer & Packages

Call /np/recharge/package with the CAS/STB number to verify customer name and get valid renewal packages.

3

Execute Recharge

Submit /np/recharge/execute with the selected package_id, amount, and reference number for instant top-up.

Step 1 • Customer & Package Inquiry

1. Retrieve DTH Customer Info & Packages

Queries the operator gateway to validate whether the customer's CAS ID / STB Number is active, retrieves the subscriber's name, and returns the list of available subscription packages with prices.

POST /api/v1/np/recharge/package

Request Headers

Field	Type	Status	Description
x-auth-token	string	required	Vendor API key obtained from Nepal Recharge Dashboard.
Content-Type	string	required	application/json
Accept	string	required	application/json

Request Body Parameters

Field	Type	Status	Description
operator_id	number	required	ID of the DTH operator (e.g. `36` for Dish Home, `40` for Clear TV).
operator_type_id	number	required	The operator category. Must be strictly `2` for DTH services.
connection_no	string	required	CAS ID, Smart Card number, or STB number of the subscriber (e.g. `71910718965` or `0000405146`).
reference_no	string	required	Unique client reference ID generated by vendor system for logging/auditing (e.g. `PKG-REF-100293`).

Code Example (Package Inquiry)

POST /api/v1/np/recharge/package

curl -X POST "https://nepalrecharge.com/api/v1/np/recharge/package" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "x-auth-token: npr_live_YOUR_API_KEY" \
  -d '{
    "operator_id": 36,
    "operator_type_id": 2,
    "connection_no": "71910718965",
    "reference_no": "PKG-REF-100293"
  }'

<?php
$curl = curl_init();

$payload = json_encode([
    'operator_id'      => 36,
    'operator_type_id' => 2,
    'connection_no'    => '71910718965',
    'reference_no'     => 'PKG-REF-' . time()
]);

curl_setopt_array($curl, [
    CURLOPT_URL            => 'https://nepalrecharge.com/api/v1/np/recharge/package',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Accept: application/json',
        'x-auth-token: npr_live_YOUR_API_KEY'
    ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

<?php
use GuzzleHttp\Client;

$client = new Client([
    'base_uri' => 'https://nepalrecharge.com/api/v1/',
    'timeout'  => 30.0,
]);

$response = $client->post('np/recharge/package', [
    'headers' => [
        'Content-Type' => 'application/json',
        'Accept'       => 'application/json',
        'x-auth-token' => 'npr_live_YOUR_API_KEY',
    ],
    'json' => [
        'operator_id'      => 36,
        'operator_type_id' => 2,
        'connection_no'    => '71910718965',
        'reference_no'     => 'PKG-REF-' . time(),
    ],
]);

$result = json_decode($response->getBody()->getContents(), true);
print_r($result);

const axios = require('axios');

axios.post('https://nepalrecharge.com/api/v1/np/recharge/package', {
  operator_id: 36,
  operator_type_id: 2,
  connection_no: '71910718965',
  reference_no: 'PKG-REF-' + Date.now()
}, {
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
    'x-auth-token': 'npr_live_YOUR_API_KEY'
  }
}).then(res => console.log(res.data))
  .catch(err => console.error(err.response ? err.response.data : err));

import requests

url = "https://nepalrecharge.com/api/v1/np/recharge/package"
headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "x-auth-token": "npr_live_YOUR_API_KEY"
}
payload = {
    "operator_id": 36,
    "operator_type_id": 2,
    "connection_no": "71910718965",
    "reference_no": "PKG-REF-100293"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Response (200 OK)

200 OK (Customer Info & Package Listing)

{
  "error": false,
  "message": "The action has been successfully performed.",
  "data": {
    "operator_id": "36",
    "connection_no": "71910718965",
    "reference_no": "PKG-REF-100293",
    "customerinfo": "Name: THULI KANXI NEPALI || STB No: 6030637001423169",
    "session_id": 2078,
    "packages": [
      {
        "id": 1,
        "name": "Standard 1 Month",
        "amount": 350
      },
      {
        "id": 2,
        "name": "HD Combo 3 Months",
        "amount": 1050
      },
      {
        "id": 3,
        "name": "Mega Annual Pack",
        "amount": 4200
      }
    ]
  }
}

Response Key	Type	Status	Description
error	boolean	always	`false` on successful customer inquiry.
message	string	always	Descriptive message from the gateway.
data.customerinfo	string	conditional	Subscriber account details returned by the DTH provider (e.g. Subscriber Name, STB Number). Display this to the user for validation.
data.session_id	number	conditional	Inquiry session token if provided by the operator backend.
data.packages[]	array	always	List of available subscription renewal plans. Each plan includes `id`, `name`, and `amount` (in NPR).

Step 2 • Recharge Execution

2. Execute DTH Recharge & Package Subscription

Executes real-time top-up on the customer's DTH account. You can pass the specific package_id obtained from the Package Inquiry API along with the verified amount.

POST /api/v1/np/recharge/execute

Request Headers

Field	Type	Status	Description
x-auth-token	string	required	Vendor API key obtained from Nepal Recharge Dashboard.
Content-Type	string	required	application/json
Accept	string	required	application/json

Request Body Parameters

Field	Type	Status	Description
operator_id	number	required	Numeric ID of the operator (e.g. `36` for Dish Home).
operator_type_id	number	required	Operator type identifier. Must be `2` for DTH services.
connection_no	string	required	CAS ID / Smartcard ID / STB Number of the customer (e.g. `71910718965`).
reference_no	string	required	Strictly unique client reference number for this recharge transaction (e.g. `DTH-ORD-88231`). Duplicate reference numbers return HTTP 409.
amount	number	required	Recharge amount in NPR. For package renewals, pass the exact package amount from the Package Inquiry response (e.g. `350`).
package_id	number \| string	required	The ID of the package selected from the Package Inquiry response (e.g. `1` or `101`). Highly recommended for package subscriptions.
package_code	string	optional	Internal package code if provided by package lookup.

Code Example (Execute Recharge)

POST /api/v1/np/recharge/execute

curl -X POST "https://nepalrecharge.com/api/v1/np/recharge/execute" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "x-auth-token: npr_live_YOUR_API_KEY" \
  -d '{
    "operator_id": 36,
    "operator_type_id": 2,
    "connection_no": "71910718965",
    "reference_no": "DTH-ORD-88231",
    "amount": 350,
    "package_id": 1
  }'

<?php
$curl = curl_init();

$payload = json_encode([
    'operator_id'      => 36,
    'operator_type_id' => 2,
    'connection_no'    => '71910718965',
    'reference_no'     => 'DTH-ORD-' . time(),
    'amount'           => 350,
    'package_id'       => 1
]);

curl_setopt_array($curl, [
    CURLOPT_URL            => 'https://nepalrecharge.com/api/v1/np/recharge/execute',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Accept: application/json',
        'x-auth-token: npr_live_YOUR_API_KEY'
    ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

<?php
use GuzzleHttp\\Client;

$client = new Client([
    'base_uri' => 'https://nepalrecharge.com/api/v1/',
    'timeout'  => 30.0,
]);

$response = $client->post('np/recharge/execute', [
    'headers' => [
        'Content-Type' => 'application/json',
        'Accept'       => 'application/json',
        'x-auth-token' => 'npr_live_YOUR_API_KEY',
    ],
    'json' => [
        'operator_id'      => 36,
        'operator_type_id' => 2,
        'connection_no'    => '71910718965',
        'amount'           => 350,
        'package_id'       => 1,
        'reference_no'     => 'DTH-ORD-' . time(),
    ],
]);

$result = json_decode($response->getBody()->getContents(), true);
print_r($result);

const axios = require('axios');

const payload = {
  operator_id: 36,
  operator_type_id: 2,
  connection_no: '71910718965',
  reference_no: 'DTH-ORD-' + Date.now(),
  amount: 350,
  package_id: 1
};

axios.post('https://nepalrecharge.com/api/v1/np/recharge/execute', payload, {
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
    'x-auth-token': 'npr_live_YOUR_API_KEY'
  }
}).then(res => console.log(res.data))
  .catch(err => console.error(err.response ? err.response.data : err));

import requests

url = "https://nepalrecharge.com/api/v1/np/recharge/execute"
headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "x-auth-token": "npr_live_YOUR_API_KEY"
}
payload = {
    "operator_id": 36,
    "operator_type_id": 2,
    "connection_no": "71910718965",
    "reference_no": "DTH-ORD-88231",
    "amount": 350,
    "package_id": 1
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Response Specifications

200 OK (Success Response)

{
  "error": false,
  "message": "Transaction Successful",
  "data": {
    "transaction_id": "TXN-NP-908234",
    "reference_no": "DTH-ORD-88231",
    "amount": 350.00,
    "credit_consumed": {
      "service_charge": 0.00,
      "instant_discount": 3.50,
      "debit_amount": 346.50
    },
    "credit_available": 12840.50,
    "commission": 3.50,
    "status": "success"
  }
}

422 Unprocessable Content (Validation Error)

{
  "error": true,
  "status": "FAILED",
  "response_code": "422",
  "error_code": "VALIDATION_ERROR",
  "field": "amount",
  "message": "Validation error: The amount field is required.",
  "hint": "Check the errors array for specific field constraints.",
  "errors": {
    "amount": ["The amount field is required."]
  },
  "data": []
}

Field	Type	Status	Description
transaction_id	string	always	Unique platform transaction reference for this recharge.
reference_no	string	always	The client reference string echoed from your request.
amount	number	always	Gross recharge face value recharged to subscriber account.
credit_consumed.debit_amount	number	always	Actual net amount deducted from your master wallet balance.
credit_available	number	always	Remaining master wallet balance after transaction settlement.
status	string	always	Recharge execution state: `success`, `queued`, or `failed`.

Previous Mobile (Ncell)

Next Voice & Data Packs

Nepal Recharge Mobile Voice & Data Packs

Voice & Data Packs

Query live cellular package catalogs and execute instant activations for 4G/5G high-speed Data Packs, Voice Minute bundles, SMS Packs, Sadhain On packs, and International Roaming plans across Ncell and Nepal Telecom (NTC).

Supported Voice & Data Operators (operator_type_id = 3)

Operator	Operator ID	Operator Type ID	Slug	Description
Ncell Data	2	3	ncell-data	Ncell 4G/5G Hourly, Daily, Weekly, and Monthly Data Packs
Ncell Voice	3	3	ncell-voice	Ncell All-Net and On-Net Voice Minute Bundles
Ncell Sadhain On	114	3	ncell-sadhain-on	Ncell Sadhain ON Combo Packs (Data + Voice + SMS)
Ncell Roaming	113	3	ncell-roaming	Ncell International Outbound Roaming Packs
NTC Data	8	3	ntc-data	Nepal Telecom 4G/LTE/FTS High-Speed Data Packs
NTC Voice	9	3	ntc-voice	Nepal Telecom All-Net and On-Net Voice Minute Packs
NTC Recommended	10	3	ntc-recommended	Popular & promotional combo offers tailored for NTC subscribers

Two-Step Subscription Architecture

1

Step 1: Inquire Package Catalog

Submit a request to /api/v1/np/recharge/package with the subscriber's mobile number and operator ID to fetch available packages along with their authoritative price and package hash.

2

Step 2: Execute Package Activation

Pass the selected package_id and exact package price to /api/v1/np/recharge/execute to instantly activate the bundle on the subscriber SIM.

STEP 1

Fetch Available Voice & Data Packages

POST /api/v1/np/recharge/package

Headers

Field	Type	Status	Description
x-auth-token	string	required	<token> (Enterprise API Key)
Content-Type	string	required	application/json
Accept	string	required	application/json

Body Parameters

Field	Type	Status	Description
operator_id	number	required	Operator ID (`2` = Ncell Data, `3` = Ncell Voice, `114` = Ncell Sadhain On, `8` = NTC Data, `9` = NTC Voice).
operator_type_id	number	required	Fixed `3` for Voice & Data Packs category.
connection_no	string	required	10-digit mobile number of the subscriber (e.g. `9801234567` or `9851012345`).
reference_no	string	required	Unique request reference string (e.g. `REF-PKG-REQ-9901`).

Request Example

POST /api/v1/np/recharge/package

curl -X POST "https://nepalrecharge.com/api/v1/np/recharge/package" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "x-auth-token: npr_live_YOUR_API_KEY" \
  -d '{
    "operator_id": 2,
    "operator_type_id": 3,
    "connection_no": "9801234567",
    "reference_no": "REF-PKG-REQ-9901"
  }'

<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL            => 'https://nepalrecharge.com/api/v1/np/recharge/package',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_POSTFIELDS     => json_encode([
        'operator_id'      => 2,
        'operator_type_id' => 3,
        'connection_no'    => '9801234567',
        'reference_no'     => 'REF-PKG-REQ-9901',
    ]),
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Accept: application/json',
        'x-auth-token: npr_live_YOUR_API_KEY',
    ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

<?php
use GuzzleHttp\Client;

$client = new Client([
    'base_uri' => 'https://nepalrecharge.com/api/v1/',
    'timeout'  => 30.0,
]);

$response = $client->post('np/recharge/package', [
    'headers' => [
        'x-auth-token' => 'npr_live_YOUR_API_KEY',
        'Content-Type' => 'application/json',
        'Accept'       => 'application/json',
    ],
    'json' => [
        'operator_id'      => 2,
        'operator_type_id' => 3,
        'connection_no'    => '9801234567',
        'reference_no'     => 'REF-PKG-REQ-9901',
    ],
]);

echo $response->getBody();

const axios = require('axios');

async function fetchPackages() {
  const payload = {
    operator_id: 2,
    operator_type_id: 3,
    connection_no: '9801234567',
    reference_no: 'REF-PKG-REQ-9901'
  };

  const res = await axios.post('https://nepalrecharge.com/api/v1/np/recharge/package', payload, {
    headers: {
      'Content-Type': 'application/json',
      'Accept': 'application/json',
      'x-auth-token': 'npr_live_YOUR_API_KEY'
    }
  });

  console.log(res.data);
}

fetchPackages();

import requests

url = "https://nepalrecharge.com/api/v1/np/recharge/package"
headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "x-auth-token": "npr_live_YOUR_API_KEY"
}
payload = {
    "operator_id": 2,
    "operator_type_id": 3,
    "connection_no": "9801234567",
    "reference_no": "REF-PKG-REQ-9901"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Response Example (Package Catalog)

200 OK

JSON Success Payload

{
  "error": false,
  "message": "The action has been successfully performed.",
  "data": [
    {
      "id": "703",
      "package_code": "703",
      "name": "1.5GB / 3 Days",
      "amount": 98,
      "description": "1.5GB All Time High Speed 4G Data - 3 Days Validity",
      "type": "Data Pack",
      "validity": "3 Days",
      "package_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
    },
    {
      "id": "705",
      "package_code": "705",
      "name": "3GB / 7 Days",
      "amount": 169,
      "description": "3GB 4G High Speed Data - 7 Days Validity",
      "type": "Data Pack",
      "validity": "7 Days",
      "package_hash": "84a7e937d53f65e2363e792f3982cb1293a54b39b0d36746cf59050d24e75d04"
    },
    {
      "id": "801",
      "package_code": "801",
      "name": "Unlimited Voice 1 Day",
      "amount": 49,
      "description": "Unlimited All-Net Voice Minutes - 24 Hours Validity",
      "type": "Voice Pack",
      "validity": "1 Day",
      "package_hash": "2f6a7d2b5c8e9f1a3d4e7b8c9a0f1e2d3c4b5a6f7e8d9c0b1a2f3e4d5c6b7a8"
    }
  ]
}

STEP 2

Execute Voice / Data Pack Subscription

POST /api/v1/np/recharge/execute

Execution Parameters

Field	Type	Status	Description
operator_id	number	required	Operator ID (`2` for Ncell Data, `8` for NTC Data, etc.).
operator_type_id	number	required	Fixed `3` for Voice & Data Packs category.
connection_no	string	required	10-digit mobile number receiving the package.
package_id	string	required	The selected `package_code` or `id` from Step 1 (e.g. `"703"`).
amount	number	required	Authoritative package price in NPR (e.g. `98`). Tamper-proof validation ensures price matches database catalog.
reference_no	string	required	Unique transaction order reference (max 80 chars). Duplicate values will be rejected with `409 Conflict`.

Execution Request Example

POST /api/v1/np/recharge/execute

curl -X POST "https://nepalrecharge.com/api/v1/np/recharge/execute" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "x-auth-token: npr_live_YOUR_API_KEY" \
  -d '{
    "operator_id": 2,
    "operator_type_id": 3,
    "connection_no": "9801234567",
    "package_id": "703",
    "amount": 98,
    "reference_no": "REF-DATAPKG-9921"
  }'

<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL            => 'https://nepalrecharge.com/api/v1/np/recharge/execute',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_POSTFIELDS     => json_encode([
        'operator_id'      => 2,
        'operator_type_id' => 3,
        'connection_no'    => '9801234567',
        'package_id'       => '703',
        'amount'           => 98,
        'reference_no'     => 'REF-DATAPKG-9921',
    ]),
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Accept: application/json',
        'x-auth-token: npr_live_YOUR_API_KEY',
    ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

<?php
use GuzzleHttp\Client;

$client = new Client([
    'base_uri' => 'https://nepalrecharge.com/api/v1/',
    'timeout'  => 30.0,
]);

$response = $client->post('np/recharge/execute', [
    'headers' => [
        'x-auth-token' => 'npr_live_YOUR_API_KEY',
        'Content-Type' => 'application/json',
        'Accept'       => 'application/json',
    ],
    'json' => [
        'operator_id'      => 2,
        'operator_type_id' => 3,
        'connection_no'    => '9801234567',
        'package_id'       => '703',
        'amount'           => 98,
        'reference_no'     => 'REF-DATAPKG-9921',
    ],
]);

echo $response->getBody();

const axios = require('axios');

async function executePackage() {
  const payload = {
    operator_id: 2,
    operator_type_id: 3,
    connection_no: '9801234567',
    package_id: '703',
    amount: 98,
    reference_no: 'REF-DATAPKG-9921'
  };

  const res = await axios.post('https://nepalrecharge.com/api/v1/np/recharge/execute', payload, {
    headers: {
      'Content-Type': 'application/json',
      'Accept': 'application/json',
      'x-auth-token': 'npr_live_YOUR_API_KEY'
    }
  });

  console.log(res.data);
}

executePackage();

import requests

url = "https://nepalrecharge.com/api/v1/np/recharge/execute"
headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "x-auth-token": "npr_live_YOUR_API_KEY"
}
payload = {
    "operator_id": 2,
    "operator_type_id": 3,
    "connection_no": "9801234567",
    "package_id": "703",
    "amount": 98,
    "reference_no": "REF-DATAPKG-9921"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Response Example (Activation Success)

200 OK

JSON Success Payload

{
  "error": false,
  "message": "Recharge executed successfully",
  "data": {
    "transaction_id": 168402914,
    "reference_no": "REF-DATAPKG-9921",
    "amount": 98.00,
    "package_id": "703",
    "package_name": "1.5GB / 3 Days",
    "credit_consumed": {
      "service_charge": 0.00,
      "instant_discount": 2.45,
      "debit_amount": 95.55
    },
    "credit_available": 8218.03,
    "status": "success"
  }
}

Response Attributes

Field	Type	Description
transaction_id	number	Unique gateway transaction ID assigned to the subscription.
package_name	string	Verified title and specifications of the activated cellular package.
credit_consumed.debit_amount	number	Net NPR amount deducted from your wallet balance after instant commission discount.
credit_available	number	Your updated merchant balance in NPR immediately following successful deduction.

Previous Nepal DTH

Next Nepal Landline

Nepal Recharge Nepal Landline

Direct Execution Payment

Landline Bill Payments (NTC PSTN)

Nepal Landline operates via Direct Execution Payment. You do not need to perform a separate bill check inquiry. Submit payment directly to /api/v1/np/recharge/execute with the destination number formatted according to specific carrier digit length rules.

Supported Landline Operators (operator_type_id = 4)

Operator	Operator ID	Operator Type ID	Required Digit Length	Example Connection Number
NTC Landline (PSTN)	11	4	8 digits (Excluding leading 0)	`14234567` (Area code 1 + 4234567)
NT FTTH Voice	101	4	9 digits	`014234567` / 9 digits
NTC Tollfree	117	4	11 digits	`16600123456` (1660 + 7 digits)

Crucial Connection Number Validation Rules:

Operator ID 11 (NTC Landline): Must be exactly 8 digits excluding the leading 0, but including the regional STD area code. For example, for Kathmandu Valley (STD code 01 and subscriber number 4234567), strip the leading zero to pass 14234567. Do NOT pass 014234567.
Operator ID 101 (NT FTTH Voice): Must be exactly 9 digits (e.g. 014234567).
Operator ID 117 (NTC Tollfree): Must be exactly 11 digits starting with carrier prefix 1660 (e.g. 16600123456).

DIRECT PAYMENT

Execute Landline Bill Payment

POST /api/v1/np/recharge/execute

Headers

Field	Type	Status	Description
x-auth-token	string	required	<token> (Enterprise API Key)
Content-Type	string	required	application/json
Accept	string	required	application/json

Body Parameters

Field	Type	Status	Description
operator_id	number	required	`11` (NTC Landline), `101` (NT FTTH Voice), or `117` (NTC Tollfree).
operator_type_id	number	required	Fixed `4` for Landline category.
connection_no	string	required	Landline number formatted by carrier rules: • Operator 11: 8 digits without leading 0 (e.g. `14234567`) • Operator 101: 9 digits (e.g. `014234567`) • Operator 117: 11 digits (e.g. `16600123456`)
amount	number	required	Direct payment amount in NPR (e.g. `500`).
reference_no	string	required	Unique client reference ID (e.g. `REF-LL-EXEC-1001`).

Direct Execution Request Example

POST /api/v1/np/recharge/execute

curl -X POST "https://nepalrecharge.com/api/v1/np/recharge/execute" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "x-auth-token: npr_live_YOUR_API_KEY" \
  -d '{
    "operator_id": 11,
    "operator_type_id": 4,
    "connection_no": "14234567",
    "amount": 500,
    "reference_no": "REF-LL-EXEC-1001"
  }'

<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL            => 'https://nepalrecharge.com/api/v1/np/recharge/execute',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_POSTFIELDS     => json_encode([
        'operator_id'      => 11,
        'operator_type_id' => 4,
        'connection_no'    => '14234567',
        'amount'           => 500,
        'reference_no'     => 'REF-LL-EXEC-1001',
    ]),
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Accept: application/json',
        'x-auth-token: npr_live_YOUR_API_KEY',
    ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

<?php
use GuzzleHttp\Client;

$client = new Client([
    'base_uri' => 'https://nepalrecharge.com/api/v1/',
    'timeout'  => 30.0,
]);

$response = $client->post('np/recharge/execute', [
    'headers' => [
        'x-auth-token' => 'npr_live_YOUR_API_KEY',
        'Content-Type' => 'application/json',
        'Accept'       => 'application/json',
    ],
    'json' => [
        'operator_id'      => 11,
        'operator_type_id' => 4,
        'connection_no'    => '14234567',
        'amount'           => 500,
        'reference_no'     => 'REF-LL-EXEC-1001',
    ],
]);

echo $response->getBody();

const axios = require('axios');

async function executeLandlinePayment() {
  const payload = {
    operator_id: 11,
    operator_type_id: 4,
    connection_no: '14234567',
    amount: 500,
    reference_no: 'REF-LL-EXEC-1001'
  };

  const res = await axios.post('https://nepalrecharge.com/api/v1/np/recharge/execute', payload, {
    headers: {
      'Content-Type': 'application/json',
      'Accept': 'application/json',
      'x-auth-token': 'npr_live_YOUR_API_KEY'
    }
  });

  console.log(res.data);
}

executeLandlinePayment();

import requests

url = "https://nepalrecharge.com/api/v1/np/recharge/execute"
headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "x-auth-token": "npr_live_YOUR_API_KEY"
}
payload = {
    "operator_id": 11,
    "operator_type_id": 4,
    "connection_no": "14234567",
    "amount": 500,
    "reference_no": "REF-LL-EXEC-1001"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Response Example (Payment Success)

200 OK

JSON Success Payload

{
  "error": false,
  "status": "SUCCESS",
  "response_code": "200",
  "message": "Transaction completed successfully",
  "data": {
    "transaction_id": "168403810",
    "reference_no": "REF-LL-EXEC-1001",
    "operator_type_id": 4,
    "operator_id": 11,
    "provider_ref": "TXN921849182",
    "provider_payment_id": "NA",
    "amount": 500,
    "credit_consumed": {
      "service_charge": 0,
      "instant_discount": 0,
      "debit_amount": 500
    },
    "credit_available": "7598.78",
    "commission": 0,
    "status": "SUCCESS"
  }
}

Response Attributes

Field	Type	Description
transaction_id	string	Gateway unique numerical transaction identifier.
operator_type_id	number	Numerical category identifier (`4` for Landline).
operator_id	number	Operator identifier (`11` for NTC Landline, `101` for NT FTTH Voice, `117` for NTC Tollfree).
credit_consumed.debit_amount	number	Actual net amount debited from your wallet working capital.
credit_available	string	Live updated corporate wallet balance after transaction clearance.
status	string	Execution status (`SUCCESS` or `PENDING`).

Previous Voice & Data Packs

Next Nepal Internet

Nepal Recharge Internet Bill Payments

Internet Bill Payments (ISP)

Complete broadband package renewals, customer account inquiries, plan upgrades, and bill payments across 40+ Nepal Internet Service Providers (ISPs), including WorldLink, Vianet, Subisu, DishHome Fibernet, Classic Tech, Websurfer, and Wifi Nepal.

Major Supported Internet Service Providers (operator_type_id = 5)

ISP Operator	Operator ID	Operator Type ID	Customer Identifier	Features Supported
WorldLink	20	5	Username / Account ID	Live Package Extraction, Expiry Date, Authoritative Pricing
Vianet	21	5	Customer ID / Username	Bill Due Inquiry, Package Listing, Instant Clearance
Subisu	19	5	Subisu Username	Live Account Check, Package Selection, Real-Time Topup
DishHome Fibernet	83	5	CAS ID / Customer ID	Package Options, Bill Breakdown, Expiry Verification
Classic Tech	32	5	Customer ID / Username	Live Balance Inquiry, Instant Recharge
Websurfer	22	5	Account ID / Username	Live Account Validation & Instant Bill Clearance
Wifi Nepal	115	5	Username / Account ID	Package Inquiries & Direct Execution
TechMinds	27	5	Username / Customer ID	Plan Options, Instant Renewal

Two-Phase ISP Architecture

1

Phase 1: Inquire Account & Extract Packages

Submit /api/v1/np/recharge/package with the ISP username and a unique reference_no. The API fetches live plans and caches them in package_details linked to this exact reference number.

2

Phase 2: Settle Renewal / Payment

Submit /api/v1/np/recharge/execute with the same reference_no from Phase 1, selected package_id, and exact amount. No bill_token is needed; the system validates against package_details.

PHASE 1

Inquire Customer Account & Packages

POST /api/v1/np/recharge/package

Headers

Field	Type	Status	Description
x-auth-token	string	required	<token> (Enterprise API Key)
Content-Type	string	required	application/json
Accept	string	required	application/json

Body Parameters

Field	Type	Status	Description
operator_id	number	required	ISP Operator ID (`20` = WorldLink, `83` = DishHome Fibernet, `21` = Vianet, `19` = Subisu, `32` = Classic Tech).
operator_type_id	number	required	Fixed `5` for Internet category.
connection_no	string	required	Subscriber username, Account ID, or Customer Code (e.g. `wl_sita_sharma`).
reference_no	string	required	Unique client reference ID (e.g. `REF-ISP-CHK-501`). Available packages will be securely stored in `package_details` under this reference number.

Inquiry Request Example

POST /api/v1/np/recharge/package

curl -X POST "https://nepalrecharge.com/api/v1/np/recharge/package"   -H "Content-Type: application/json"   -H "Accept: application/json"   -H "x-auth-token: npr_live_YOUR_API_KEY"   -d '{
    "operator_id": 20,
    "operator_type_id": 5,
    "connection_no": "wl_sita_sharma",
    "reference_no": "REF-ISP-CHK-501"
  }'

<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL            => 'https://nepalrecharge.com/api/v1/np/recharge/package',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_POSTFIELDS     => json_encode([
        'operator_id'      => 20,
        'operator_type_id' => 5,
        'connection_no'    => 'wl_sita_sharma',
        'reference_no'     => 'REF-ISP-CHK-501',
    ]),
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Accept: application/json',
        'x-auth-token: npr_live_YOUR_API_KEY',
    ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

<?php
use GuzzleHttp\Client;

$client = new Client([
    'base_uri' => 'https://nepalrecharge.com/api/v1/',
    'timeout'  => 30.0,
]);

$response = $client->post('np/recharge/package', [
    'headers' => [
        'x-auth-token' => 'npr_live_YOUR_API_KEY',
        'Content-Type' => 'application/json',
        'Accept'       => 'application/json',
    ],
    'json' => [
        'operator_id'      => 20,
        'operator_type_id' => 5,
        'connection_no'    => 'wl_sita_sharma',
        'reference_no'     => 'REF-ISP-CHK-501',
    ],
]);

echo $response->getBody();

const axios = require('axios');

async function checkISP() {
  const payload = {
    operator_id: 20,
    operator_type_id: 5,
    connection_no: 'wl_sita_sharma',
    reference_no: 'REF-ISP-CHK-501'
  };

  const res = await axios.post('https://nepalrecharge.com/api/v1/np/recharge/package', payload, {
    headers: {
      'Content-Type': 'application/json',
      'Accept': 'application/json',
      'x-auth-token': 'npr_live_YOUR_API_KEY'
    }
  });

  console.log(res.data);
}

checkISP();

import requests

url = "https://nepalrecharge.com/api/v1/np/recharge/package"
headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "x-auth-token": "npr_live_YOUR_API_KEY"
}
payload = {
    "operator_id": 20,
    "operator_type_id": 5,
    "connection_no": "wl_sita_sharma",
    "reference_no": "REF-ISP-CHK-501"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Response Example (Verified ISP Details & Stored Packages)

200 OK

JSON Success Payload

{
  "error": false,
  "message": "The action has been successfully performed.",
  "data": {
    "operator_id": "20",
    "connection_no": "wl_sita_sharma",
    "reference_no": "REF-ISP-CHK-501",
    "session_id": "78291410",
    "packages": {
      "options": [
        {
          "id": "PKG-WL-200M-1M",
          "name": "Photon 200 Mbps (1 Month)",
          "amount": 1243
        },
        {
          "id": "PKG-WL-200M-3M",
          "name": "Photon 200 Mbps (3 Months)",
          "amount": 3500
        },
        {
          "id": "PKG-WL-300M-12M",
          "name": "Photon 300 Mbps (12 Months Annual)",
          "amount": 13500
        }
      ]
    },
    "expiry_date": "2026-10-15"
  }
}

Response Attributes

Field	Type	Description
operator_id	string	Echoes the verified ISP operator identifier.
connection_no	string	Broadband username or subscriber account code.
reference_no	string	The order reference key. The retrieved packages are securely cached under this reference in the backend database table `package_details`.
packages.options	array	List of selectable renewal packages containing package `id`, `name`, and authoritative price `amount` in NPR.
expiry_date	string / null	The subscriber's current subscription renewal/due date returned by the ISP provider.

PHASE 2

Execute Internet Renewal Payment

POST /api/v1/np/recharge/execute

No bill_token Required — Authoritative Package Linking

When executing an Internet package renewal, you must pass the same reference_no that was sent in Step 1 (/recharge/package). The gateway retrieves the package details and upstream credentials from package_details table, validates the authoritative price against tampering, and triggers immediate activation. No bill_token is required!

Headers

Field	Type	Status	Description
x-auth-token	string	required	<token> (Enterprise API Key)
Content-Type	string	required	application/json
Accept	string	required	application/json

Execution Parameters

Field	Type	Status	Description
operator_id	number	required	ISP Operator ID (e.g. `20` for WorldLink).
operator_type_id	number	required	Fixed `5` for Internet category.
connection_no	string	required	ISP Username / Subscriber Account ID (e.g. `wl_sita_sharma`).
reference_no	string	required	Must match the same `reference_no` sent in Step 1 (`REF-ISP-CHK-501`). Used to retrieve the selected package record from `package_details`.
package_id	string	required	The selected renewal package ID from Step 1 options (e.g. `"PKG-WL-200M-1M"`).
amount	number	required	Exact package price in NPR (e.g. `1243`). Must match authoritative price in `package_details`.

Execution Request Example

POST /api/v1/np/recharge/execute

curl -X POST "https://nepalrecharge.com/api/v1/np/recharge/execute"   -H "Content-Type: application/json"   -H "Accept: application/json"   -H "x-auth-token: npr_live_YOUR_API_KEY"   -d '{
    "operator_id": 20,
    "operator_type_id": 5,
    "connection_no": "wl_sita_sharma",
    "reference_no": "REF-ISP-CHK-501",
    "package_id": "PKG-WL-200M-1M",
    "amount": 1243
  }'

<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL            => 'https://nepalrecharge.com/api/v1/np/recharge/execute',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_POSTFIELDS     => json_encode([
        'operator_id'      => 20,
        'operator_type_id' => 5,
        'connection_no'    => 'wl_sita_sharma',
        'reference_no'     => 'REF-ISP-CHK-501',
        'package_id'       => 'PKG-WL-200M-1M',
        'amount'           => 1243,
    ]),
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Accept: application/json',
        'x-auth-token: npr_live_YOUR_API_KEY',
    ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

<?php
use GuzzleHttp\Client;

$client = new Client([
    'base_uri' => 'https://nepalrecharge.com/api/v1/',
    'timeout'  => 30.0,
]);

$response = $client->post('np/recharge/execute', [
    'headers' => [
        'x-auth-token' => 'npr_live_YOUR_API_KEY',
        'Content-Type' => 'application/json',
        'Accept'       => 'application/json',
    ],
    'json' => [
        'operator_id'      => 20,
        'operator_type_id' => 5,
        'connection_no'    => 'wl_sita_sharma',
        'reference_no'     => 'REF-ISP-CHK-501',
        'package_id'       => 'PKG-WL-200M-1M',
        'amount'           => 1243,
    ],
]);

echo $response->getBody();

const axios = require('axios');

async function executeInternetPayment() {
  const payload = {
    operator_id: 20,
    operator_type_id: 5,
    connection_no: 'wl_sita_sharma',
    reference_no: 'REF-ISP-CHK-501',
    package_id: 'PKG-WL-200M-1M',
    amount: 1243
  };

  const res = await axios.post('https://nepalrecharge.com/api/v1/np/recharge/execute', payload, {
    headers: {
      'Content-Type': 'application/json',
      'Accept': 'application/json',
      'x-auth-token': 'npr_live_YOUR_API_KEY'
    }
  });

  console.log(res.data);
}

executeInternetPayment();

import requests

url = "https://nepalrecharge.com/api/v1/np/recharge/execute"
headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "x-auth-token": "npr_live_YOUR_API_KEY"
}
payload = {
    "operator_id": 20,
    "operator_type_id": 5,
    "connection_no": "wl_sita_sharma",
    "reference_no": "REF-ISP-CHK-501",
    "package_id": "PKG-WL-200M-1M",
    "amount": 1243
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Response Example (Payment Success)

200 OK

JSON Success Payload

{
  "error": false,
  "status": "SUCCESS",
  "response_code": "200",
  "message": "Recharge executed successfully",
  "data": {
    "transaction_id": "168404550",
    "reference_no": "REF-ISP-CHK-501",
    "operator_type_id": 5,
    "operator_id": 20,
    "provider_ref": "TXN88219412",
    "provider_payment_id": "NA",
    "amount": 1243,
    "credit_consumed": {
      "service_charge": 0,
      "instant_discount": 12.43,
      "debit_amount": 1230.57
    },
    "credit_available": "6368.21",
    "commission": 12.43,
    "status": "SUCCESS"
  }
}

Response Attributes

Field	Type	Description
transaction_id	string	Unique gateway transaction ID for bookkeeping and reconciliation.
reference_no	string	Echoes the vendor reference ID linked to the `package_details` entry.
operator_type_id	number	Identifies the service vertical (`5` for Internet).
operator_id	number	ISP operator code (e.g. `20` for WorldLink).
provider_ref	string	Upstream carrier audit STAN or switch confirmation reference.
amount	number	Total face value amount renewed in NPR.
credit_consumed.debit_amount	number	Actual net amount deducted from merchant wallet (face amount minus instant discount).
credit_available	string	Merchant's remaining prepaid credit balance in NPR.
commission	number	B2B margin rebate earned by partner on this renewal.
status	string	Execution result: `SUCCESS`, `PENDING`, or `FAILED`.

Previous Nepal Landline

Next Electricity (NEA)

Nepal Recharge Nepal Electricity Check Bills for NEA

Check Bills for NEA

This API allows you to check due bills, pending dues, and retrieve customer billing sessions for Nepal Electricity Authority (NEA).

Mandatory Utility Parameters

NEA Electricity requires office_code (Counter Code, e.g. 360), sc_no (Sub-center No, e.g. 021.18.031), and connection_no (Customer ID, e.g. 267434). Query available counters using the Office Code Lookup API.

POST /api/v1/np/recharge/check

Headers

Field	Type	Status	Description
x-auth-token	string	required	<token>
Content-Type	string	required	application/json
Accept	string	required	application/json

Body Parameters

Field	Type	Status	Description
operator_id	number	required	Fixed `44` for Nepal Electricity Authority.
operator_type_id	number	required	Fixed `6` for Electricity utility category.
connection_no	string	required	Customer ID / Account number printed on NEA consumer bill (e.g. `267434`).
office_code	string	required	Distribution counter code (e.g. `360` for Kathmandu Central / Ratnapark). See Office Code Lookup.
sc_no	string	required	Service Connection Number / Sub-Center printed on bill (e.g. `021.18.031`).
reference_no	string	required	Unique inquiry reference generated by your platform (e.g. `CHK-NEA-9921`).
phone	string	required	Nepali 10-digit customer mobile phone for SMS notification alerts (e.g. `9811802255`).

Request Example

POST /api/v1/np/recharge/check

curl -X POST "https://nepalrecharge.com/api/v1/np/recharge/check" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "x-auth-token: npr_live_YOUR_API_KEY" \
  -d '{
    "operator_id": 44,
    "operator_type_id": 6,
    "connection_no": "267434",
    "office_code": "360",
    "sc_no": "021.18.031",
    "reference_no": "CHK-NEA-9921",
    "phone": "9811802255"
  }'

<?php
$curl = curl_init();

$payload = json_encode([
    'operator_id'      => 44,
    'operator_type_id' => 6,
    'connection_no'    => '267434',
    'office_code'      => '360',
    'sc_no'            => '021.18.031',
    'reference_no'     => 'CHK-NEA-' . time(),
    'phone'            => '9811802255'
]);

curl_setopt_array($curl, [
    CURLOPT_URL            => 'https://nepalrecharge.com/api/v1/np/recharge/check',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Accept: application/json',
        'x-auth-token: npr_live_YOUR_API_KEY'
    ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

<?php
use GuzzleHttp\Client;

$client = new Client([
    'base_uri' => 'https://nepalrecharge.com/api/v1/',
    'timeout'  => 30.0,
]);

$response = $client->post('np/recharge/check', [
    'headers' => [
        'Content-Type' => 'application/json',
        'Accept'       => 'application/json',
        'x-auth-token' => 'npr_live_YOUR_API_KEY',
    ],
    'json' => [
        'operator_id'      => 44,
        'operator_type_id' => 6,
        'connection_no'    => '267434',
        'office_code'      => '360',
        'sc_no'            => '021.18.031',
        'reference_no'     => 'CHK-NEA-' . time(),
        'phone'            => '9811802255',
    ],
]);

$result = json_decode($response->getBody()->getContents(), true);
print_r($result);

const axios = require('axios');

axios.post('https://nepalrecharge.com/api/v1/np/recharge/check', {
  operator_id: 44,
  operator_type_id: 6,
  connection_no: '267434',
  office_code: '360',
  sc_no: '021.18.031',
  reference_no: 'CHK-NEA-' + Date.now(),
  phone: '9811802255'
}, {
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
    'x-auth-token': 'npr_live_YOUR_API_KEY'
  }
}).then(res => console.log(res.data))
  .catch(err => console.error(err.response ? err.response.data : err));

import requests

url = "https://nepalrecharge.com/api/v1/np/recharge/check"
headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "x-auth-token": "npr_live_YOUR_API_KEY"
}
payload = {
    "operator_id": 44,
    "operator_type_id": 6,
    "connection_no": "267434",
    "office_code": "360",
    "sc_no": "021.18.031",
    "reference_no": "CHK-NEA-9921",
    "phone": "9811802255"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Response Examples

200 OK Bill Details Fetched (Success)

{
  "status": "success",
  "response_code": 200,
  "message": "Bill details fetched successfully",
  "data": {
    "bill_token": "BILL-BEB2FD27D7D043252A4FCD13A22037D9",
    "customer_name": "RAMESH KUMAR SAH",
    "connection_no": "267434",
    "office_code": "360",
    "office_name": "Ratnapark (Kathmandu Central)",
    "sc_no": "021.18.031",
    "total_due_amount": 100.00,
    "payable_amount": 100.00,
    "min_advance_amount": 1.00,
    "penalty_amount": 0.00,
    "rebate_amount": 0.00,
    "bills": [
      {
        "bill_date": "2026-09-15",
        "due_date": "2026-09-30",
        "bill_amount": 100.00,
        "status": "UNPAID"
      }
    ]
  }
}

Response Attributes

Field	Type	Description
bill_token	string	Unique billing session identifier. Pass this token directly to the Execute Payment API.
customer_name	string	Name of the electricity consumer as registered with NEA.
payable_amount	number	Total payable bill amount in NPR after rebates or late payment fines.
bills	array	List of monthly invoice breakdowns, bill dates, due dates, and individual bill status.

Previous DishHome DTH

Next Execute Payment for NEA

Nepal Recharge Nepal Electricity Execute Payment for NEA

Execute Payment for NEA

Submits payment execution for NEA Electricity bills using the verified bill_token obtained from the Check Bills API.

POST /api/v1/np/recharge/execute

Headers

Field	Type	Status	Description
x-auth-token	string	required	<token>
Content-Type	string	required	application/json
Accept	string	required	application/json

Body Parameters

Field	Type	Status	Description
amount	number	required	Payment amount in NPR. For zero-balance accounts, advance payments of ≥ NPR 1.00 are allowed.
bill_token	string	optional	Active session bill token returned by Check Bills API. Optional if passing the same `reference_no` used during bill check.
operator_id	number	required	Fixed `44` for Nepal Electricity Authority.
operator_type_id	number	required	Fixed `6` for Electricity utility category.
connection_no	string	required	Customer ID / Account number printed on consumer bill (e.g. `267434`).
office_code	string	required	Distribution counter code (e.g. `360`).
sc_no	string	required	Service Connection Number / Sub-Center (e.g. `021.18.031`).
reference_no	string	required	Unique transaction reference generated by your platform. You can pass the same reference_no sent during `/recharge/check` to automatically authorize the session, or provide a new reference along with `bill_token`.
phone	string	optional	Customer mobile phone number for instant payment receipt SMS.

Request Example

POST /api/v1/np/recharge/execute

curl -X POST "https://nepalrecharge.com/api/v1/np/recharge/execute" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "x-auth-token: npr_live_YOUR_API_KEY" \
  -d '{
    "operator_id": 44,
    "operator_type_id": 6,
    "connection_no": "267434",
    "office_code": "360",
    "sc_no": "021.18.031",
    "reference_no": "EXEC-NEA-1001",
    "bill_token": "BILL-BEB2FD27D7D043252A4FCD13A22037D9",
    "amount": 100.00,
    "phone": "9811802255"
  }'

<?php
$curl = curl_init();

$payload = json_encode([
    'operator_id'      => 44,
    'operator_type_id' => 6,
    'connection_no'    => '267434',
    'office_code'      => '360',
    'sc_no'            => '021.18.031',
    'reference_no'     => 'EXEC-NEA-' . time(),
    'bill_token'       => 'BILL-BEB2FD27D7D043252A4FCD13A22037D9',
    'amount'           => 100.00,
    'phone'            => '9811802255'
]);

curl_setopt_array($curl, [
    CURLOPT_URL            => 'https://nepalrecharge.com/api/v1/np/recharge/execute',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Accept: application/json',
        'x-auth-token: npr_live_YOUR_API_KEY'
    ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

<?php
use GuzzleHttp\Client;

$client = new Client([
    'base_uri' => 'https://nepalrecharge.com/api/v1/',
    'timeout'  => 30.0,
]);

$response = $client->post('np/recharge/execute', [
    'headers' => [
        'Content-Type' => 'application/json',
        'Accept'       => 'application/json',
        'x-auth-token' => 'npr_live_YOUR_API_KEY',
    ],
    'json' => [
        'operator_id'      => 44,
        'operator_type_id' => 6,
        'connection_no'    => '267434',
        'office_code'      => '360',
        'sc_no'            => '021.18.031',
        'reference_no'     => 'EXEC-NEA-' . time(),
        'bill_token'       => 'BILL-BEB2FD27D7D043252A4FCD13A22037D9',
        'amount'           => 100.00,
        'phone'            => '9811802255',
    ],
]);

$result = json_decode($response->getBody()->getContents(), true);
print_r($result);

const axios = require('axios');

axios.post('https://nepalrecharge.com/api/v1/np/recharge/execute', {
  operator_id: 44,
  operator_type_id: 6,
  connection_no: '267434',
  office_code: '360',
  sc_no: '021.18.031',
  reference_no: 'EXEC-NEA-' + Date.now(),
  bill_token: 'BILL-BEB2FD27D7D043252A4FCD13A22037D9',
  amount: 100.00,
  phone: '9811802255'
}, {
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
    'x-auth-token': 'npr_live_YOUR_API_KEY'
  }
}).then(res => console.log(res.data))
  .catch(err => console.error(err.response ? err.response.data : err));

import requests

url = "https://nepalrecharge.com/api/v1/np/recharge/execute"
headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "x-auth-token": "npr_live_YOUR_API_KEY"
}
payload = {
    "operator_id": 44,
    "operator_type_id": 6,
    "connection_no": "267434",
    "office_code": "360",
    "sc_no": "021.18.031",
    "reference_no": "EXEC-NEA-1001",
    "bill_token": "BILL-BEB2FD27D7D043252A4FCD13A22037D9",
    "amount": 100.00,
    "phone": "9811802255"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Response Examples

200 OK Bill Payment Executed Successfully

{
  "status": "success",
  "response_code": 200,
  "message": "NEA electricity bill payment executed successfully.",
  "data": {
    "transaction_id": "TXN-NEA-9921045",
    "reference_no": "EXEC-NEA-1001",
    "bill_token": "BILL-BEB2FD27D7D043252A4FCD13A22037D9",
    "operator_id": 44,
    "operator_name": "Nepal Electricity Authority (NEA)",
    "connection_no": "267434",
    "amount": 100.00,
    "status": "SUCCESS",
    "account_balance": 85320.50,
    "receipt_no": "NEA-REC-20260930-8812"
  }
}

Response Attributes

Field	Type	Description
transaction_id	string	Unique platform gateway transaction identifier for dispute resolution and webhook tracking.
status	string	Final execution status: `SUCCESS` or `PENDING`.
account_balance	number	Remaining wallet balance in NPR after debiting the bill amount and applying any commission.
receipt_no	string	Official NEA counter receipt reference for offline verification.

Previous Check Bills for NEA

Next Check Bills for Khanepani

Nepal Recharge Khanepani Check Bills for Khanepani

Utility Bill Check operator_id: 46

Check Bills for Khanepani (Drinking Water)

Queries real-time water utility billing details for Drinking Water (खानेपानी) boards across Nepal (including KUKL, Lalitpur, Pokhara, Biratnagar, Dharan, Butwal, Bhaktapur, and more). It validates consumer credentials, fetches pending bill dues, fines, rebates, and issues a 15-minute cryptographically secured bill_token session lock required to execute payments.

Important Khanepani Integration Rules:

Month ID is Mandatory: You must supply month_id (Nepali BS month 1–12, or 0 for current month).
Office Code / Counter: Find valid counter codes for your branch via GET /api/v1/np/utility/counters?type=khanepani or Office Code Lookup.
Unique Reference: Each check call requires a unique reference_no. Reusing a reference will return 409 DUPLICATE_REFERENCE_NUMBER.
15-Minute Token TTL: The returned bill_token expires after 15 minutes (900 seconds).

Endpoints

Universal Recharge Route

POST /api/v1/np/recharge/check

Dedicated Water Route

POST /api/v1/np/water/check

Headers

Header	Type	Description
x-auth-token	string	Required Your live or test API Token (e.g. `npr_live_...`).
Content-Type	string	`application/json`
Accept	string	`application/json`

Request Body Parameters

Parameter	Type	Status	Description
operator_id	number	Required*	`46` (Fixed ID for Khanepani. Required on `/recharge/check`).
operator_type_id	number	Required*	`7` (Khanepani Water category ID).
connection_no	string	Required	Consumer / Customer ID or Meter Number (e.g. `252-8846` or `102938`).
office_code	string	Required	Khanepani counter / branch code (e.g. `4`). Query active counters dynamically via `GET /api/v1/np/utility/counters?type=khanepani`.
month_id	string\|number	Required	Bikram Sambat (BS) month: 1=Baisakh 2=Jestha 3=Ashadh 4=Shrawan 5=Bhadra 6=Ashwin 7=Kartik 8=Mangsir 9=Poush 10=Magh 11=Falgun 12=Chaitra 0=Current Month
reference_no	string	Required	Unique check reference number generated by your application (e.g. `CHK-WATER-882194`). Cannot be reused.

Request Example

POST /api/v1/np/recharge/check

curl -X POST "https://nepalrecharge.com/api/v1/np/recharge/check" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "x-auth-token: npr_live_YOUR_API_KEY" \
  -d '{
    "operator_id": 46,
    "operator_type_id": 7,
    "connection_no": "252-8846",
    "office_code": "4",
    "month_id": "0",
    "reference_no": "CHK-WATER-882194"
  }'

<?php
$curl = curl_init();

$payload = json_encode([
    'operator_id'      => 46,
    'operator_type_id' => 7,
    'connection_no'    => '252-8846',
    'office_code'      => '4',
    'month_id'         => '0',
    'reference_no'     => 'CHK-WATER-' . time(),
]);

curl_setopt_array($curl, [
    CURLOPT_URL            => 'https://nepalrecharge.com/api/v1/np/recharge/check',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Accept: application/json',
        'x-auth-token: npr_live_YOUR_API_KEY'
    ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

<?php
use GuzzleHttp\\Client;

$client = new Client([
    'base_uri' => 'https://nepalrecharge.com/api/v1/',
    'timeout'  => 30.0,
]);

$response = $client->post('np/recharge/check', [
    'headers' => [
        'Content-Type' => 'application/json',
        'Accept'       => 'application/json',
        'x-auth-token' => 'npr_live_YOUR_API_KEY',
    ],
    'json' => [
        'operator_id'      => 46,
        'operator_type_id' => 7,
        'connection_no'    => '252-8846',
        'office_code'      => '4',
        'month_id'         => '0',
        'reference_no'     => 'CHK-WATER-' . time(),
    ],
]);

$result = json_decode($response->getBody()->getContents(), true);
print_r($result);

const axios = require('axios');

axios.post('https://nepalrecharge.com/api/v1/np/recharge/check', {
  operator_id: 46,
  operator_type_id: 7,
  connection_no: '252-8846',
  office_code: '4',
  month_id: '0',
  reference_no: 'CHK-WATER-' + Date.now()
}, {
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
    'x-auth-token': 'npr_live_YOUR_API_KEY'
  }
}).then(res => console.log(res.data))
  .catch(err => console.error(err.response ? err.response.data : err));

import requests

url = "https://nepalrecharge.com/api/v1/np/recharge/check"
headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "x-auth-token": "npr_live_YOUR_API_KEY"
}
payload = {
    "operator_id": 46,
    "operator_type_id": 7,
    "connection_no": "252-8846",
    "office_code": "4",
    "month_id": "0",
    "reference_no": "CHK-WATER-882194"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Response Payloads

200 OK Bill Dues Found (Includes Detailed Payments Array)

{
  "error": false,
  "message": "The action has been successfully performed.",
  "data": {
    "customer_name": "RAM BAHADUR SHRESTHA",
    "connection_no": "252-8846",
    "reference_no": "CHK-WATER-882194",
    "bill_amount": "116.70",
    "bill_token": "BILL-06B04B988A8736D621DC8EB220C06AD7",
    "payments": [
      {
        "address": "KATHMANDU WARD 4, MAHARAJGUNJ",
        "mobile_number": "9811802255",
        "current_month_dues": "100.00",
        "current_month_discount": "5.00",
        "current_month_fine": "0.00",
        "total_credit_sales_amount": "NA",
        "total_advance_amount": 0.00,
        "previous_dues": 21.70,
        "total_dues": 116.70
      }
    ]
  }
}

Detailed Response Fields & Payments Breakdown

customer_name: Registered consumer name associated with meter.

bill_amount: Exact total net payable amount in NPR (including fines/rebates).

bill_token: 15-minute cryptographic session lock for payment execution.

total_advance_amount: Existing credit/advance deposit already in water account.

previous_dues: Arrears carried forward from prior unpaid months.

current_month_fine: Late penalty levied by the water authority switch.

422 MONTH_ID_REQUIRED

{
  "error": true,
  "status": "FAILED",
  "response_code": "422",
  "error_code": "MONTH_ID_REQUIRED",
  "message": "month_id is required for Khanepani water bill inquiry."
}

409 DUPLICATE_REFERENCE

{
  "error": true,
  "status": "FAILED",
  "response_code": "409",
  "error_code": "DUPLICATE_REFERENCE_NUMBER",
  "message": "Duplicate reference_no: Has already been used. Use a unique reference_no."
}

Previous Execute Payment for NEA

Next Execute Payment for Khanepani

Nepal Recharge Khanepani Execute Payment for Khanepani

Payment Execution operator_id: 46

Execute Payment for Khanepani (Drinking Water)

Executes instant drinking water utility payments or advance deposits using the active bill_token session lock obtained during the bill check step. Includes automatic underpayment blocking, advance deposits, and real-time transaction reconciliation.

Underpayment Forbidden

Partial bill payments are strictly disallowed by Nepal water utility switches. If the verified bill is NPR 116.70, submitting NPR 100.00 will be rejected immediately with BILL_UNDERPAYMENT_FORBIDDEN to prevent account arrears disputes.

Advance Payment System

Paying MORE than the verified bill is fully supported. Any excess amount is credited directly to the customer's Khanepani advance deposit balance for future bills. For accounts with NPR 0.00 dues, deposit any advance amount (min NPR 1.00).

Endpoints

Universal Execution Route

POST /api/v1/np/recharge/execute

Dedicated Water Route

POST /api/v1/np/water/execute

Body Parameters

Parameter	Type	Status	Description
bill_token	string	Required	Active session token issued by the Check Bills API (e.g. `BILL-06B04B988A8736D621DC8EB220C06AD7`). Valid for 15 minutes.
operator_id	number	Required*	`46` (Fixed ID for Khanepani).
operator_type_id	number	Required*	`7` for Khanepani Water.
connection_no	string	Required	Consumer / Customer Number (must match check session, e.g. `252-8846`).
office_code	string	Required	Khanepani counter code (e.g. `4`).
reference_no	string	Required	Unique execution order reference (e.g. `EXEC-WATER-20260930-01`). Used for webhook reconciliation.
amount	number	Required	Payment amount in NPR. Must be greater than or equal to the verified `bill_amount` (or min NPR 1.00 if zero dues).
advance_amount	number	Optional	Optional advance credit deposit amount when submitting zero-due or prepaid balance.

Execution Request Example

POST /api/v1/np/recharge/execute

curl -X POST "https://nepalrecharge.com/api/v1/np/recharge/execute" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "x-auth-token: npr_live_YOUR_API_KEY" \
  -d '{
    "operator_id": 46,
    "operator_type_id": 7,
    "connection_no": "252-8846",
    "office_code": "4",
    "reference_no": "EXEC-WATER-20260930-01",
    "bill_token": "BILL-06B04B988A8736D621DC8EB220C06AD7",
    "amount": 116.70
  }'

<?php
$curl = curl_init();

$payload = json_encode([
    'operator_id'      => 46,
    'operator_type_id' => 7,
    'connection_no'    => '252-8846',
    'office_code'      => '4',
    'reference_no'     => 'EXEC-WATER-' . time(),
    'bill_token'       => 'BILL-06B04B988A8736D621DC8EB220C06AD7',
    'amount'           => 116.70,
]);

curl_setopt_array($curl, [
    CURLOPT_URL            => 'https://nepalrecharge.com/api/v1/np/recharge/execute',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Accept: application/json',
        'x-auth-token: npr_live_YOUR_API_KEY'
    ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

<?php
use GuzzleHttp\\Client;

$client = new Client([
    'base_uri' => 'https://nepalrecharge.com/api/v1/',
    'timeout'  => 30.0,
]);

$response = $client->post('np/recharge/execute', [
    'headers' => [
        'Content-Type' => 'application/json',
        'Accept'       => 'application/json',
        'x-auth-token' => 'npr_live_YOUR_API_KEY',
    ],
    'json' => [
        'operator_id'      => 46,
        'operator_type_id' => 7,
        'connection_no'    => '252-8846',
        'office_code'      => '4',
        'reference_no'     => 'EXEC-WATER-' . time(),
        'bill_token'       => 'BILL-06B04B988A8736D621DC8EB220C06AD7',
        'amount'           => 116.70,
    ],
]);

$result = json_decode($response->getBody()->getContents(), true);
print_r($result);

const axios = require('axios');

axios.post('https://nepalrecharge.com/api/v1/np/recharge/execute', {
  operator_id: 46,
  operator_type_id: 7,
  connection_no: '252-8846',
  office_code: '4',
  reference_no: 'EXEC-WATER-' + Date.now(),
  bill_token: 'BILL-06B04B988A8736D621DC8EB220C06AD7',
  amount: 116.70
}, {
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
    'x-auth-token': 'npr_live_YOUR_API_KEY'
  }
}).then(res => console.log(res.data))
  .catch(err => console.error(err.response ? err.response.data : err));

import requests

url = "https://nepalrecharge.com/api/v1/np/recharge/execute"
headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "x-auth-token": "npr_live_YOUR_API_KEY"
}
payload = {
    "operator_id": 46,
    "operator_type_id": 7,
    "connection_no": "252-8846",
    "office_code": "4",
    "reference_no": "EXEC-WATER-20260930-01",
    "bill_token": "BILL-06B04B988A8736D621DC8EB220C06AD7",
    "amount": 116.70
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Response Payloads

200 OK Payment Executed Successfully

{
  "error": false,
  "status": "SUCCESS",
  "response_code": "00",
  "message": "Khanepani water bill payment successfully processed.",
  "data": {
    "transaction_id": "TXN-20260930-WTR-994821",
    "reference_no": "EXEC-WATER-20260930-01",
    "connection_no": "252-8846",
    "office_code": "4",
    "customer_name": "RAM BAHADUR SHRESTHA",
    "amount": 116.70,
    "currency": "NPR",
    "operator": "Khanepani Water",
    "status": "success",
    "receipt_url": "https://nepalrecharge.com/receipt/TXN-20260930-WTR-994821"
  }
}

422 UNDERPAYMENT BLOCKED

{
  "error": true,
  "status": "FAILED",
  "response_code": "422",
  "error_code": "BILL_UNDERPAYMENT_FORBIDDEN",
  "message": "Bill underpayment blocked: The verified Khanepani bill for '252-8846' is NPR 116.70, but you submitted NPR 100.00. Partial payments are strictly forbidden.",
  "hint": "You must submit at least the verified bill amount: NPR 116.70."
}

422 BILL_CHECK_REQUIRED

{
  "error": true,
  "status": "FAILED",
  "response_code": "422",
  "error_code": "BILL_CHECK_REQUIRED",
  "message": "Bill verification required: For Khanepani, you must first inspect the due bill via POST /api/v1/np/water/check before executing payment."
}

Previous Check Bills for Khanepani

Next Operator Lookup

Additional Nepal APIs Operator Lookup

Operator Lookup

Retrieve all active telecom, DTH, ISP, electricity, and water operators available on the Nepal Recharge platform along with their amount limits and service codes.

GET /api/v1/np/operators

Headers

Field	Type	Status	Description
x-auth-token	string	required	<token>
Accept	string	required	application/json

Query Parameters

Field	Type	Status	Description
operator_type_id	number	optional	Filter by category (`1`: Mobile, `2`: DTH, `3`: Data Packs, `5`: Internet, `6`: Electricity, `7`: Water). Omit to retrieve all active operators.

Request Example

GET /api/v1/np/operators?operator_type_id=1

curl -X GET "https://nepalrecharge.com/api/v1/np/operators?operator_type_id=1" \
  -H "Accept: application/json" \
  -H "x-auth-token: npr_live_YOUR_API_KEY"

<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL            => 'https://nepalrecharge.com/api/v1/np/operators?operator_type_id=1',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'GET',
    CURLOPT_HTTPHEADER     => [
        'Accept: application/json',
        'x-auth-token: npr_live_YOUR_API_KEY'
    ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

<?php
use GuzzleHttp\Client;

$client = new Client([
    'base_uri' => 'https://nepalrecharge.com/api/v1/',
    'timeout'  => 30.0,
]);

$response = $client->get('np/operators', [
    'headers' => [
        'Accept'       => 'application/json',
        'x-auth-token' => 'npr_live_YOUR_API_KEY',
    ],
    'query' => [
        'operator_type_id' => 1,
    ],
]);

$result = json_decode($response->getBody()->getContents(), true);
print_r($result);

const axios = require('axios');

axios.get('https://nepalrecharge.com/api/v1/np/operators', {
  params: {
    operator_type_id: 1
  },
  headers: {
    'Accept': 'application/json',
    'x-auth-token': 'npr_live_YOUR_API_KEY'
  }
}).then(res => console.log(res.data))
  .catch(err => console.error(err.response ? err.response.data : err));

import requests

url = "https://nepalrecharge.com/api/v1/np/operators"
headers = {
    "Accept": "application/json",
    "x-auth-token": "npr_live_YOUR_API_KEY"
}
params = {
    "operator_type_id": 1
}

response = requests.get(url, headers=headers, params=params)
print(response.json())

Response Examples

200 OK Active Operators List

{
  "error": false,
  "message": "Operators fetched successfully.",
  "country": "NP",
  "data": [
    {
      "value": 1,
      "label": "Ncell",
      "operator_id": 1,
      "operator_type_id": 1,
      "slug": "ncell",
      "service_code": "NCELL",
      "country": "NP",
      "min_amount": 10.00,
      "max_amount": 5000.00
    },
    {
      "value": 5,
      "label": "Nepal Telecom (NTC)",
      "operator_id": 5,
      "operator_type_id": 1,
      "slug": "ntc",
      "service_code": "NTC",
      "country": "NP",
      "min_amount": 10.00,
      "max_amount": 5000.00
    },
    {
      "value": 36,
      "label": "DishHome",
      "operator_id": 36,
      "operator_type_id": 2,
      "slug": "dish-home",
      "service_code": "DISHHOME",
      "country": "NP",
      "min_amount": 100.00,
      "max_amount": 10000.00
    },
    {
      "value": 44,
      "label": "Nepal Electricity Authority (NEA)",
      "operator_id": 44,
      "operator_type_id": 6,
      "slug": "nea",
      "service_code": "NEA",
      "country": "NP",
      "min_amount": 1.00,
      "max_amount": 100000.00
    },
    {
      "value": 46,
      "label": "Khanepani (Water)",
      "operator_id": 46,
      "operator_type_id": 7,
      "slug": "khanepani",
      "service_code": "KHANEPANI",
      "country": "NP",
      "min_amount": 1.00,
      "max_amount": 50000.00
    }
  ]
}

Response Attributes

Field	Type	Description
operator_id	number	Unique platform operator identifier required in execution and check payloads.
operator_type_id	number	Category ID indicating service type (1: Mobile, 2: DTH, 6: Electricity, 7: Water).
service_code	string	Short upstream provider code.
min_amount / max_amount	number	Allowed recharge denomination boundaries in NPR.

Additional Nepal APIs Operator Type Lookup

Operator Type Lookup

Retrieve all supported utility service categories and operator types for Nepal (Mobile, DTH, Internet, Electricity, Water).

GET /api/v1/np/operators/type

Headers

Field	Type	Status	Description
x-auth-token	string	required	<token>
Accept	string	required	application/json

Request Example

GET /api/v1/np/operators/type

curl -X GET "https://nepalrecharge.com/api/v1/np/operators/type" \
  -H "Accept: application/json" \
  -H "x-auth-token: npr_live_YOUR_API_KEY"

<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL            => 'https://nepalrecharge.com/api/v1/np/operators/type',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'GET',
    CURLOPT_HTTPHEADER     => [
        'Accept: application/json',
        'x-auth-token: npr_live_YOUR_API_KEY'
    ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

<?php
use GuzzleHttp\Client;

$client = new Client([
    'base_uri' => 'https://nepalrecharge.com/api/v1/',
    'timeout'  => 30.0,
]);

$response = $client->get('np/operators/type', [
    'headers' => [
        'Accept'       => 'application/json',
        'x-auth-token' => 'npr_live_YOUR_API_KEY',
    ],
]);

$result = json_decode($response->getBody()->getContents(), true);
print_r($result);

const axios = require('axios');

axios.get('https://nepalrecharge.com/api/v1/np/operators/type', {
  headers: {
    'Accept': 'application/json',
    'x-auth-token': 'npr_live_YOUR_API_KEY'
  }
}).then(res => console.log(res.data))
  .catch(err => console.error(err.response ? err.response.data : err));

import requests

url = "https://nepalrecharge.com/api/v1/np/operators/type"
headers = {
    "Accept": "application/json",
    "x-auth-token": "npr_live_YOUR_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())

Response Examples

200 OK Operator Types List

{
  "error": false,
  "message": "Operator types fetched successfully.",
  "country": "NP",
  "data": [
    { "value": 1, "label": "Mobile Recharge" },
    { "value": 2, "label": "DTH Recharge" },
    { "value": 3, "label": "Data Packs" },
    { "value": 5, "label": "Internet Bill" },
    { "value": 6, "label": "Electricity (NEA)" },
    { "value": 7, "label": "Khanepani (Water)" }
  ]
}

Response Attributes

Field	Type	Description
value	number	The operator type category ID (e.g. 1 for Mobile, 6 for Electricity, 7 for Water).
label	string	Display name for the service category.

Additional Nepal APIs Office Code Lookup

Office Code Lookup

Retrieve all available distribution counter codes and offices for utility operators like Nepal Electricity Authority (NEA) and Khanepani Water.

GET /api/v1/np/office-codes

Headers

Field	Type	Status	Description
x-auth-token	string	required	<token>
Accept	string	required	application/json

Query Parameters

Field	Type	Status	Description
operator_id	number	required	Utility operator identifier (`44` for Nepal Electricity Authority, `46` for Khanepani Water, `125` for Community Khanepani).
operator_type_id	number	required	Utility operator category identifier (`6` for Electricity, `7` for Water). Must match the operator's category.
search	string	optional	Optional keyword to filter counters by name or code (e.g. `"Ratnapark"` or `"360"`).

Request Example

GET /api/v1/np/office-codes?operator_id=44&operator_type_id=6

curl -X GET "https://nepalrecharge.com/api/v1/np/office-codes?operator_id=44&operator_type_id=6" \
  -H "Accept: application/json" \
  -H "x-auth-token: npr_live_YOUR_API_KEY"

<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL            => 'https://nepalrecharge.com/api/v1/np/office-codes?operator_id=44&operator_type_id=6',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'GET',
    CURLOPT_HTTPHEADER     => [
        'Accept: application/json',
        'x-auth-token: npr_live_YOUR_API_KEY'
    ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

<?php
use GuzzleHttp\Client;

$client = new Client([
    'base_uri' => 'https://nepalrecharge.com/api/v1/',
    'timeout'  => 30.0,
]);

$response = $client->get('np/office-codes', [
    'headers' => [
        'Accept'       => 'application/json',
        'x-auth-token' => 'npr_live_YOUR_API_KEY',
    ],
    'query' => [
        'operator_id'      => 44,
        'operator_type_id' => 6,
    ],
]);

$result = json_decode($response->getBody()->getContents(), true);
print_r($result);

const axios = require('axios');

axios.get('https://nepalrecharge.com/api/v1/np/office-codes', {
  params: {
    operator_id: 44,
    operator_type_id: 6
  },
  headers: {
    'Accept': 'application/json',
    'x-auth-token': 'npr_live_YOUR_API_KEY'
  }
}).then(res => console.log(res.data))
  .catch(err => console.error(err.response ? err.response.data : err));

import requests

url = "https://nepalrecharge.com/api/v1/np/office-codes"
headers = {
    "Accept": "application/json",
    "x-auth-token": "npr_live_YOUR_API_KEY"
}
params = {
    "operator_id": 44,
    "operator_type_id": 6
}

response = requests.get(url, headers=headers, params=params)
print(response.json())

Response Examples

200 OK Office Counters List

{
  "error": false,
  "message": "Office codes fetched successfully.",
  "operator_id": 44,
  "data": [
    {
      "operator_id": 44,
      "office_code": "360",
      "service_code": "NEA",
      "office_name": "Ratnapark (Kathmandu Central)",
      "utility_type": "electricity"
    },
    {
      "operator_id": 44,
      "office_code": "361",
      "service_code": "NEA",
      "office_name": "Lagankhel (Lalitpur)",
      "utility_type": "electricity"
    },
    {
      "operator_id": 44,
      "office_code": "362",
      "service_code": "NEA",
      "office_name": "Bhaktapur Counter",
      "utility_type": "electricity"
    },
    {
      "operator_id": 44,
      "office_code": "401",
      "service_code": "NEA",
      "office_name": "Pokhara Counter",
      "utility_type": "electricity"
    },
    {
      "operator_id": 44,
      "office_code": "101",
      "service_code": "NEA",
      "office_name": "Biratnagar Counter",
      "utility_type": "electricity"
    }
  ]
}

Response Attributes

Field	Type	Description
office_code	string	Official distribution counter code required in electricity check/execute requests.
office_name	string	Human-readable branch or regional distribution counter name.
utility_type	string	Service domain (e.g. `electricity` or `water`).

Previous Operator Type Lookup

Next Package Listing

Additional Nepal APIs Package Listing & Discovery

Package Listing & Plan Discovery

Discover active cellular 4G/5G data packs, voice minute bundles, broadband ISP renewal subscriptions, and DTH television plans across Nepal Telecom (NTC), Ncell, WorldLink, Vianet, Subisu, and DishHome.

1

Dynamic Subscriber Package Inquiry

Submit POST /api/v1/np/recharge/package with the customer identifier. Queries the operator switch live, verifies subscriber eligibility, and stores valid renewal plans into package_details for subsequent execution.

2

Operator Catalog Plans Lookup

Submit GET /api/v1/utility/operators/{operator}/plans using the operator slug or ID. Returns all active database package bundles to populate pricing tables and plan pickers in your customer UI.

METHOD 1

Live Subscriber Package Discovery

Connects to the upstream operator or service database, checks subscriber status, and returns all available packages. For ISPs and DTH, plans are securely indexed in package_details under the provided reference_no.

POST /api/v1/np/recharge/package

Supported Categories & Operator Types

Category	Type ID	Supported Operators	Connection Number Format
Voice & Data Packs	3	Ncell (`1`), NTC Prepaid/Postpaid (`2, 3`), SmartCell (`4`)	10-digit mobile (e.g. 9801037488)
Broadband Internet (ISP)	5	WorldLink (`20`), Vianet (`21`), Subisu (`19`), DishHome Fibernet (`83`), Classic Tech (`32`)	Broadband Username / Account ID
DTH / Cable TV	2	DishHome TV (`6`), Mero TV (`34`), SIM TV (`35`)	CAS ID / Smart Card / STB No

Headers

Field	Type	Status	Description
x-auth-token	string	required	<token> (Enterprise API Key)
Content-Type	string	required	application/json
Accept	string	required	application/json

Body Parameters

Field	Type	Status	Description
operator_id	number	required	Target operator identifier (e.g. `1` for Ncell, `20` for WorldLink).
operator_type_id	number	required	`3` for Voice & Data Packs, `5` for Internet, or `2` for DTH.
connection_no	string	required	Subscriber identifier (10-digit mobile number, broadband username, or CAS ID).
reference_no	string	required	Unique order reference generated by vendor. For ISPs, extracted plans are stored in `package_details` under this reference number.

Request Example (Live Package Listing)

POST /api/v1/np/recharge/package

curl -X POST "https://nepalrecharge.com/api/v1/np/recharge/package"   -H "Content-Type: application/json"   -H "Accept: application/json"   -H "x-auth-token: npr_live_YOUR_API_KEY"   -d '{
    "operator_id": 1,
    "operator_type_id": 3,
    "connection_no": "9801037488",
    "reference_no": "REF-PKG-88214"
  }'

<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL            => 'https://nepalrecharge.com/api/v1/np/recharge/package',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_POSTFIELDS     => json_encode([
        'operator_id'      => 1,
        'operator_type_id' => 3,
        'connection_no'    => '9801037488',
        'reference_no'     => 'REF-PKG-88214',
    ]),
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Accept: application/json',
        'x-auth-token: npr_live_YOUR_API_KEY',
    ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

<?php
use GuzzleHttp\Client;

$client = new Client([
    'base_uri' => 'https://nepalrecharge.com/api/v1/',
    'timeout'  => 30.0,
]);

$response = $client->post('np/recharge/package', [
    'headers' => [
        'x-auth-token' => 'npr_live_YOUR_API_KEY',
        'Content-Type' => 'application/json',
        'Accept'       => 'application/json',
    ],
    'json' => [
        'operator_id'      => 1,
        'operator_type_id' => 3,
        'connection_no'    => '9801037488',
        'reference_no'     => 'REF-PKG-88214',
    ],
]);

echo $response->getBody();

const axios = require('axios');

async function fetchPackages() {
  const payload = {
    operator_id: 1,
    operator_type_id: 3,
    connection_no: '9801037488',
    reference_no: 'REF-PKG-88214'
  };

  const res = await axios.post('https://nepalrecharge.com/api/v1/np/recharge/package', payload, {
    headers: {
      'Content-Type': 'application/json',
      'Accept': 'application/json',
      'x-auth-token': 'npr_live_YOUR_API_KEY'
    }
  });

  console.log(res.data);
}

fetchPackages();

import requests

url = "https://nepalrecharge.com/api/v1/np/recharge/package"
headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "x-auth-token": "npr_live_YOUR_API_KEY"
}
payload = {
    "operator_id": 1,
    "operator_type_id": 3,
    "connection_no": "9801037488",
    "reference_no": "REF-PKG-88214"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Response Example (Cellular Packs)

200 OK

JSON Success Payload

{
  "error": false,
  "message": "The action has been successfully performed.",
  "data": {
    "connection_no": "9801037488",
    "operator_id": "1",
    "operator_type_id": "3",
    "reference_no": "REF-PKG-88214",
    "session_id": null,
    "packages": [
      {
        "id": "101",
        "name": "Non-Stop YouTube 7 Days",
        "amount": 150,
        "description": "Unlimited YouTube streaming + 4GB all-net data",
        "type": "Data Service",
        "validity": "7days"
      },
      {
        "id": "102",
        "name": "Sadhain On 28 Days 20GB",
        "amount": 499,
        "description": "20GB All-Net 4G Data + 500 Voice Mins + 100 SMS",
        "type": "Data Service",
        "validity": "28days"
      }
    ]
  }
}

METHOD 2

Operator Catalog Plans Lookup

Retrieve all predefined active package bundles for a given operator slug or ID without requiring a customer phone number. Ideal for building browse menus, plan selectors, or pricing pages.

GET /api/v1/utility/operators/{operator}/plans

Path Parameters

Parameter	Type	Status	Description
operator	string / int	required	Operator slug (e.g. `ncell`, `ntc`) or numeric operator ID (e.g. `1`, `2`).

Catalog Plans Request Example

GET /api/v1/utility/operators/ncell/plans

curl -X GET "https://nepalrecharge.com/api/v1/utility/operators/ncell/plans"   -H "Accept: application/json"   -H "x-auth-token: npr_live_YOUR_API_KEY"

<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL            => 'https://nepalrecharge.com/api/v1/utility/operators/ncell/plans',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'GET',
    CURLOPT_HTTPHEADER     => [
        'Accept: application/json',
        'x-auth-token: npr_live_YOUR_API_KEY',
    ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

<?php
use GuzzleHttp\Client;

$client = new Client([
    'base_uri' => 'https://nepalrecharge.com/api/v1/',
    'timeout'  => 30.0,
]);

$response = $client->get('utility/operators/ncell/plans', [
    'headers' => [
        'Accept'       => 'application/json',
        'x-auth-token' => 'npr_live_YOUR_API_KEY',
    ],
]);

echo $response->getBody();

const axios = require('axios');

async function getPlans() {
  const res = await axios.get('https://nepalrecharge.com/api/v1/utility/operators/ncell/plans', {
    headers: {
      'Accept': 'application/json',
      'x-auth-token': 'npr_live_YOUR_API_KEY'
    }
  });

  console.log(res.data);
}

getPlans();

import requests

url = "https://nepalrecharge.com/api/v1/utility/operators/ncell/plans"
headers = {
    "Accept": "application/json",
    "x-auth-token": "npr_live_YOUR_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())

Response Example (Catalog Plans)

200 OK

JSON Catalog Payload

{
  "error": false,
  "message": "Plans fetched successfully.",
  "operator_id": 1,
  "operator_name": "Ncell",
  "data": [
    {
      "id": 101,
      "plan_name": "Non-Stop YouTube 7 Days",
      "amount": 150,
      "validity": "7days",
      "description": "Unlimited YouTube streaming + 4GB all-net data",
      "data_benefit": "4GB"
    },
    {
      "id": 102,
      "plan_name": "Sadhain On 28 Days 20GB",
      "amount": 499,
      "validity": "28days",
      "description": "20GB All-Net 4G Data + 500 Voice Mins + 100 SMS",
      "data_benefit": "20GB"
    }
  ]
}

Response Attributes

Field	Type	Description
id	string / int	The unique package ID to submit in `/recharge/execute`.
name / plan_name	string	Commercial plan title (e.g. Non-Stop YouTube, Photon 200M).
amount	number	Authoritative retail price in NPR. Must be matched exactly in execution.
validity	string	Active pack duration (e.g. `7days`, `28days`, `1year`).
data_benefit	string	Primary high-speed data quota included in the bundle.

Previous Office Code Lookup

Next API Reference Guide

Introduction API Reference Guide

API Reference Guide

Complete quickstart specification for integrating the Nepal Recharge B2B API into your applications.

Base Production URL HTTPS Mandatory

https://nepalrecharge.com/api/v1/

Quick Integration in 3 Steps:

1

Obtain API Token

Generate your API key from the vendor portal and pass it in x-auth-token header.

2

Perform Bill Check

For utilities (NEA / Water), execute /check to retrieve due amount and active bill_token.

3

Execute Payment

Send recharge execution request to /execute with a unique reference_no.

Previous Welcome

Next API Changelog

Introduction API Changelog

v2.4.0 Current Stable Release

API Changelog & Release Notes

Stay up to date with new features, endpoint enhancements, security advisories, deprecation schedules, and breaking change notifications across the Nepal Recharge API platform.

Current Version

v2.4.0

Production Ready

Active Endpoints

14+

RESTful Unified

Supported Services

70+

ISPs, NEA, PSTN, Mobile

Code Stacks

5 SDKs

cURL, PHP, Guzzle, Node, Py

v2.4.0

Landline, Internet ISPs & Voice/Data Packs Launch

September 2026

NEW FEATURE Nepal Telecom (NTC PSTN) Landline Bill Payments

Added full support for fixed telephone lines (Operator ID 11, Type 4), NT FTTH Voice SIP lines (ID 101), and NTC 1660 Toll-Free numbers (ID 117) with optional bill checking and live payments.

NEW FEATURE Broadband & Internet Service Providers (40+ ISPs)

Added full ISP renewal and bill payment support (Type 5) covering WorldLink (ID 20), Vianet (ID 21), Subisu (ID 19), DishHome Fibernet (ID 83), Classic Tech (ID 32), Websurfer (ID 22), and Wifi Nepal (ID 115). Features live package extraction and 15-minute anti-tampering session locks.

NEW FEATURE Voice & Data Packs Catalog & Execution

Added cellular package inquiry (POST /api/v1/np/recharge/package) and execution (Type 3) for Ncell Data, Ncell Voice, Ncell Sadhain On, Ncell Roaming, NTC Data, and NTC Voice packs with HMAC-verified package hashes.

ENHANCEMENT Universal 5-Stack Code Snippets & Status Badges

Standardized all code example panels to feature all 5 major developer stacks (cURL, PHP cURL, Guzzle, Node.js, and Python) with interactive tab switching and copy-to-clipboard functionality. Added explicit required and optional status badges across all parameter tables.

v2.3.0

Utility Bill Payment & Wallet Inquiries

August 2026

NEW FEATURE Nepal Electricity Authority (NEA) Two-Step Verification

Launched dedicated endpoints /api/v1/np/electricity/check and /api/v1/np/recharge/execute with NEA counter codes, consumer IDs, bill token caching, and advance payment allowances.

NEW FEATURE Khanepani Water Bill Clearance

Implemented municipal community water board payments (Type 7) with counter verification and dynamic rebate calculations.

NEW FEATURE Merchant Wallet Balance API

Released GET /api/v1/wallet/balance enabling enterprise partners to query available credit, currency, account status, and low-balance thresholds programmatically.

v2.2.0

DTH Services & Fraud Protection Enhancements

June 2026

NEW FEATURE Nepal DTH (DishHome & Mero TV) Recharge

Launched DTH Customer Inquiry and recharge execution (Type 2) with smart card CAS validation and package pricing.

SECURITY Strict Duplicate Order Reference Check (409 Conflict)

Enforced absolute uniqueness on merchant reference_no values across transactions to eliminate accidental double debits.

SECURITY Authoritative Server-Side Pricing

Guaranteed that client-submitted recharge amounts are cross-verified against system package catalogs. If tampering is detected, transactions are rejected with validation errors.

v2.1.0

Modern Developer SDKs & Rate Limiting

March 2026

ENHANCEMENT Dual PHP Engine Integration (Native cURL + Guzzle HTTP)

Provided distinct code samples for both legacy procedural PHP projects (curl_init) and modern Composer-based frameworks (GuzzleHttp\Client).

ENHANCEMENT Granular Error Envelopes with Hints

Upgraded failure responses to include structured metadata: error_code, offending field, and actionable resolution hint strings.

v2.0.0

Unified Enterprise Gateway Launch

January 2026

NEW FEATURE Next-Gen Unified API Architecture

Complete redesign of Nepal mobile topups under /api/v1/np/recharge/execute with automated commission discounts (instant_discount), wallet balances, and real-time transaction reconciliation.

SECURITY x-auth-token & IP Whitelisting Security

Replaced unauthenticated endpoints with strict SHA-256 encrypted API token verification and optional server IP restrictions.

Versioning & Deprecation Policy

Nepal Recharge adheres strictly to Semantic Versioning 2.0 (SemVer). Version numbers follow the format MAJOR.MINOR.PATCH:

Major Version (v2.x)

Introduces breaking architectural changes or new authentication standards. Announced with a minimum of 180 days advance deprecation window.

Minor Version (v2.4.x)

Adds new bill payment operators, utility categories, or optional query parameters in a strictly backwards-compatible manner.

Patch Version (v2.4.1)

Includes performance optimizations, internal bug fixes, and security patches without altering endpoint signatures.

Previous API Reference Guide

Next API Basics

Introduction API Basics

REST Architecture

API Basics

A comprehensive overview of REST API design principles, HTTP verbs, parameter types, standard response structures, and HTTP status codes implemented by Nepal Recharge.

What are REST APIs?

Nepal Recharge API follows the REST (Representational State Transfer) architectural design. All requests transfer state via predictable URLs, use standard HTTP verbs for operations, accept JSON-encoded request bodies, and return standardized JSON responses.

Resource Oriented

Predictable hierarchical URIs organized around business domains like /np/recharge and /wallet.

Strict JSON Envelope

Both request payloads and responses use standard UTF-8 JSON with explicit Content-Type headers.

Stateless & Idempotent

Every request carries its own credentials. Recharges use reference_no to prevent duplicate debiting.

Supported HTTP Methods

Method	Scope	Idempotent	Description
GET	Read / Fetch	Yes	Retrieves data without modifying server state (e.g. balance inquiry, operator lookups).
POST	Execute / Query	With ref_no	Executes financial transactions (recharges, package inquiry, bill payments) or submits data.

Parameter Classification

Parameters across our API documentation are categorized into 4 primary locations:

1. Header Parameters: required

Supplied in HTTP headers. E.g. x-auth-token: npr_live_... and Content-Type: application/json.

2. Path Parameters: required

Embedded directly in URI endpoint paths. E.g. /api/v1/np/status/{transactionId}.

3. Request Body Parameters: required / optional

JSON object payload passed in POST requests. Every parameter table in these docs specifies whether it is strictly REQUIRED or OPTIONAL.

4. Query Parameters: optional

Key-value pairs appended after ? in GET requests (e.g. /np/operators?country=NP).

HTTP Response Status Codes

Code	Status	Category	Meaning & Action
200 OK	Success	2xx Success	The request was processed successfully. Check `data` object.
400 Bad Request	Client Error	4xx Client	Malformed JSON syntax or missing request headers.
401 Unauthorized	Auth Error	4xx Client	Missing/invalid `x-auth-token`, or caller server IP is not whitelisted.
404 Not Found	Not Found	4xx Client	Invalid operator ID or transaction reference does not exist in database.
409 Conflict	Duplicate	4xx Client	Strict duplicate `reference_no` detected. Generate a new reference ID.
422 Unprocessable	Validation	4xx Client	Validation failed (e.g. invalid phone length, missing amount, invalid operator_type).
429 Too Many Req	Throttled	4xx Client	Rate limit exceeded. Check `Retry-After` response header.
500 / 502 / 504	Server Error	5xx Server	Internal upstream gateway error. Query status API with your `reference_no`.

Previous API Reference Guide

Next API Authentication

Introduction API Authentication

Enterprise Security

API Authentication

All Nepal Recharge API endpoints require authentication using confidential API Keys passed in HTTP headers. Requests are secured with IP address binding and TLS 1.3 encryption.

The `x-auth-token` Header

Every HTTP request to https://nepalrecharge.com/api/v1/ must include your token in the x-auth-token request header:

Header Name	Type	Status	Description
x-auth-token	string	required	Your secret vendor API token (e.g. `npr_live_9fa82...`).
Content-Type	string	required	application/json
Accept	string	required	application/json

Security Alert: Keep your API token strictly confidential. Never commit keys into frontend codebases, public repositories, or mobile client apps.

IP Whitelisting & Environments

Server IP Whitelisting

Each API token is bound to one or more authorized static public IP addresses of your backend servers. Incoming requests originating from non-whitelisted IPs will be rejected immediately with HTTP 401.

Test vs. Live Modes

Test Tokens: Allow testing request workflows, validating schemas, and observing webhook callbacks without live wallet deductions.
Live Tokens: Execute real-time mobile top-ups and bill settlements against your live wallet balance.

Authentication Failure (401 Unauthorized)

401 Unauthorized Response

{
  "error": true,
  "status": "FAILED",
  "response_code": "401",
  "error_code": "UNAUTHORIZED",
  "message": "Invalid or missing API token. Please provide a valid 'x-auth-token' header.",
  "data": []
}

Previous API Basics

Next Rate Limiting

Introduction Rate Limiting

Traffic Protection

Rate Limiting

Nepal Recharge employs dynamic rate limiters to protect the platform against traffic bursts, ensure 99.99% system availability, and distribute upstream operator capacity fairly across all vendors.

Default Quotas & Limits

Standard Recharge 60 req / min Per vendor API token

Burst Concurrency 10 req / sec Short spike absorption

Status Inquiry 120 req / min Polling & audit checks

Rate Limit Response Headers

Every response returned by Nepal Recharge includes standard rate limit headers to assist your client application in managing request frequency:

Header	Example Value	Description
X-RateLimit-Limit	60	The total number of requests permitted within the 1-minute time window.
X-RateLimit-Remaining	42	The number of requests remaining in the current rate limit window.
Retry-After	12	Returned with HTTP 429. Number of seconds to wait before resubmitting.

Exponential Backoff with Full Jitter

When an HTTP 429 response is received, your application should pause and retry using Exponential Backoff with Jitter. Adding a random variation prevents the thundering herd problem where many clients retry simultaneously:

Python Implementation (Safe Retry with Jitter)

import time
import random
import requests

def execute_with_retry(payload, max_retries=3):
    url = "https://nepalrecharge.com/api/v1/np/recharge/execute"
    headers = {
        "Content-Type": "application/json",
        "x-auth-token": "npr_live_YOUR_API_KEY"
    }
    
    for attempt in range(max_retries):
        res = requests.post(url, json=payload, headers=headers)
        
        if res.status_code == 200:
            return res.json()
        
        if res.status_code == 429:
            retry_after = int(res.headers.get("Retry-After", 2 ** attempt))
            jitter = random.uniform(0.1, 0.5)
            sleep_time = retry_after + jitter
            print(f"Rate limited (429). Retrying in {sleep_time:.2f}s...")
            time.sleep(sleep_time)
            continue
            
        return res.json()
        
    raise Exception("Max retries exceeded")

Previous API Authentication

Next Best Practices

Introduction Best Practices

Production Readiness

API Best Practices & Guidelines

Key recommendations, architectural blueprints, idempotency strategies, failure recovery patterns, and security principles for robust, high-volume production integrations.

1. Idempotency & Reference Number Hygiene

Every recharge execution request requires a unique merchant-generated reference_no (maximum 80 characters). Our gateway treats reference_no as an idempotency key:

Recommended Pattern

Generate UUID v4 or prefixed alphanumeric IDs (e.g., ORD-2026-NCELL-99214). Store this ID in your local database before sending the HTTP request. If a network blip occurs, query the status using this reference before any retry.

Anti-Pattern to Avoid

Never reuse the same reference_no across multiple transactions or blindly generate a new reference number on timeout. Reusing an existing reference triggers an immediate 409 Conflict (DUPLICATE_REFERENCE_NUMBER).

2. Two-Step Verification for Utilities & ISPs

For utilities like NEA Electricity (operator_type_id: 6), Khanepani Water (operator_type_id: 7), and Internet ISPs (operator_type_id: 5), always implement the two-step verification pattern:

The Inquiry-to-Execution Pipeline

Phase 1

Call /check or /package with the consumer number. Display the customer name, outstanding balance, and package choices to your end-user for confirmation.

Phase 2

For utility bills (NEA Electricity, Khanepani Water), pass the returned bill_token directly into /api/v1/np/recharge/execute. For broadband internet package renewals, pass the same reference_no from Phase 1 alongside the chosen package_id and authoritative price—no bill_token required!

3. Authoritative Pricing & Package Hash Defense

To shield partners against malicious client-side price tampering (e.g. attempting to purchase a NPR 500 data pack with amount = 50), the gateway employs Authoritative Server-Side Pricing:

• When subscribing to Voice & Data Packs (operator_type_id: 3) or DTH/ISP packages, retrieve the package catalog via POST /api/v1/np/recharge/package.

• When calling /execute, pass the exact authoritative price. If your system passes an unverified or discounted amount, the gateway automatically validates against the official tariff table and overrides or rejects the request with 422 INVALID_PACKAGE_PLAN.

4. HTTP Timeouts & The Re-query Pattern

Telecom carriers occasionally take several seconds to process SIM airtime additions. Implementing robust timeout management prevents double charges:

Recommended HTTP Timeouts

Connection Timeout: 10 seconds
Read / Socket Timeout: 35 seconds

Handling Read Timeout (504 Gateway Timeout)

A timeout does not mean the recharge failed. The upstream carrier may have finished the credit. Instead of retrying, query GET /api/v1/np/status/{orderId} after 5-10 seconds.

5. Wallet Balance Health & Low-Balance Thresholds

All transactions are settled instantaneously in real-time from your prepaid B2B credit wallet. If available balance falls below the transaction amount, executions are rejected with 422 INSUFFICIENT_BALANCE:

• Integrate an automated cron job or scheduled monitor calling GET /api/v1/wallet/balance every 5-15 minutes.

• Trigger internal alert notifications (Slack, Email, SMS) to your finance team when balance drops below your operational threshold (e.g. NPR 25,000).

6. Credential Security & Static IP Whitelisting

API Key Protection

Store your API key exclusively in environment variables (.env). Never commit tokens to Git repositories or expose them in browser JavaScript or mobile client code.

Static IP Whitelisting

For enterprise production accounts, contact support to register your static outbound server IP addresses. Requests from unapproved IP addresses are rejected with 403 Forbidden.

Previous Rate Limiting

Next Glossary

Introduction Glossary

Domain Dictionary

Fintech & Telecom Glossary

A reference dictionary of terms, parameters, abbreviations, carrier codes, and financial concepts used throughout the Nepal Recharge API specifications.

Telecommunications & Mobile Concepts

Term	Definition & Usage
connection_no	The subscriber destination identifier. For GSM mobile lines, this is a 10-digit number starting with 98 or 97. For PSTN landlines, it is the area code followed by the line number (e.g. 014234567). For ISPs, it is the customer username.
operator_id	Unique integer identifying the service provider in our system: `1` (Ncell), `5` (NTC Prepaid), `6` (NTC Postpaid), `11` (NTC Landline), `20` (WorldLink), `44` (NEA).
operator_type_id	Category classification integer: `1` = Mobile Topup, `2` = DTH Satellite TV, `3` = Voice & Data Packs, `4` = Landline (PSTN), `5` = Internet (ISP), `6` = Electricity, `7` = Khanepani Water.
PSTN	Public Switched Telephone Network — standard wired landline telephone service operated across Nepal primarily by Nepal Telecom.
FTTH	Fiber To The Home — optical fiber connectivity delivering high-speed internet, IPTV, and digital SIP landline voice telephony.
Sadhain On	Special Ncell pack plans combining voice talk time, data volume, and SMS packs into an auto-renewing or unified monthly bundle.

Utility Billing & Verification Terms

Term	Definition & Usage
bill_token	A signed billing session token generated during utility `/check` (e.g. NEA Electricity, Khanepani Water). It locks the authoritative due amount, customer details, and invoice parameters for 15 minutes (900s) to ensure payment precision. (Note: Broadband Internet package renewals do not require a bill_token; they use the same `reference_no` via `package_details`).
package_details	Backend transactional cache table that stores live ISP packages, `bill_number`, and `refstan` indexed by `reference_no` during `/recharge/package`. Used in `/recharge/execute` to validate authoritative pricing and prevent price tampering.
office_code	The NEA or Khanepani distribution counter code identifying the exact regional branch servicing the meter. Queryable via `/api/np/utility/office-codes`.
consumer_id	The unique numerical consumer customer number printed on the customer's utility electricity bill (distinct from SC No).
sc_no	Service Connection Number assigned to an electricity or water meter, typically formatted as `XXX.XX.XXX`.
advance_amount	Permitted for NEA and Khanepani utilities when there is zero outstanding bill due. Allows customers to pre-fund their account balance for upcoming billing cycles.

Financial & Settlement Terms

Term	Definition & Usage
instant_discount	The real-time partner commission calculated and refunded instantly at execution time. E.g., for a 2.5% commission on NPR 100, `instant_discount` is 2.50.
debit_amount	The exact net currency subtracted from your prepaid working balance: `debit_amount = amount - instant_discount + service_charge`.
credit_available	The live post-transaction balance remaining in your B2B wallet denominated in Nepalese Rupees (NPR).
reference_no	Your internal merchant transaction ID. Passed in recharge executions to guarantee idempotency and avoid duplicate debits.
transaction_id	Our gateway-generated numeric tracking key (e.g. `168402914`) representing the transaction in logs and reconciliation statements.

API Architecture & Security

Term	Definition & Usage
x-auth-token	The mandatory custom HTTP request header carrying your enterprise API access token.
package_hash	An HMAC-SHA256 hash issued with each package plan to certify the authenticity of the price and validity combination.
Idempotency	The design property ensuring identical requests produce the same state without repetitive financial execution.

Previous Best Practices

Next Ncell Mobile Recharge

Developer Tools About Webhooks

About Webhooks

Real-time asynchronous event notifications pushed directly to your application backend whenever transactions complete, state changes, or queue resolutions occur upstream.

Instant Push Events

No need for aggressive polling loops. As soon as an upstream telecom carrier (Ncell, NTC) or utility board (NEA, Khanepani) confirms a bill settlement, our gateway sends an HTTP POST event to your URL.

Cryptographic Security

Every incoming payload includes a cryptographic X-Webhook-Signature header generated using HMAC SHA-256 with your shared secret key.

Guaranteed Delivery

If your server is down or returns a non-2xx status, our retry engine automatically reschedules deliveries with exponential backoff across 24 hours (immediate, 1m, 5m, 15m, 1h, 6h, 24h).

Supported Webhook Event Types

Event Name	Trigger Condition	Recommended Action
recharge.success	Transaction was accepted and successfully executed by the upstream operator switch.	Credit end-user account, mark order as completed, send SMS receipt.
recharge.failed	Upstream operator rejected payment (e.g. invalid subscriber, subscriber inactive, bill already paid).	Mark order failed, auto-refund end-user or release held merchant balance.
recharge.refunded	Transaction was reversed due to downstream settlement reversal or switch timeout.	Re-credit vendor merchant wallet balance and log audit trail.
webhook.test	Simulated test ping triggered from Partner Portal to verify endpoint connectivity.	Verify signature and return `{"status": "ok"}` with HTTP 200.

HTTP Headers Sent With Every Webhook

Header	Type	Example Value	Purpose
X-Webhook-Signature	string	t=1759300200,v1=9a8b7c6d...	HMAC-SHA256 signature for payload verification and anti-tampering.
X-Webhook-Event	string	recharge.success	The specific event trigger name.
X-Webhook-Timestamp	string	1759300200	Unix epoch timestamp when the webhook was generated (used for replay defense).
Content-Type	string	application/json	All payloads are delivered as standard JSON objects.

Standard Webhook Payload Structure

JSON POST

POST https://yourdomain.com/api/webhook/nepal-recharge

{
  "event": "recharge.success",
  "timestamp": 1759300200,
  "data": {
    "transaction_id": "168404550",
    "reference_no": "ORD-2026-98124",
    "operator_id": 1,
    "operator_name": "Ncell",
    "operator_type_id": 1,
    "connection_no": "9801037488",
    "amount": 100.00,
    "commission": 2.50,
    "net_deducted": 97.50,
    "provider_reference": "TXN88219412",
    "provider_payment_id": "NA",
    "status": "SUCCESS",
    "response_code": "00",
    "message": "Recharge executed successfully",
    "completed_at": "2026-09-30T19:30:05+05:45"
  }
}

Previous Credit Card Validation

Next Webhook Best Practices

Developer Tools Webhook Best Practices

Webhook Best Practices

Essential architecture guidelines, idempotency handlers, and security considerations to ensure zero-downtime, fault-tolerant webhook processing.

1

Acknowledge Fast With HTTP 200 (Under 3 Seconds)

Our webhook delivery engine enforces a strict 5-second connection timeout. Do NOT perform heavy synchronous operations (such as generating PDF invoices, sending external WhatsApp messages, or blocking database locks) directly in your webhook handler.

Recommended Pattern: Validate signature → Push payload into internal message queue (Redis / RabbitMQ / SQS) → Return HTTP 200 OK immediately → Process business logic asynchronously.

2

Implement Idempotency Guards

In distributed networks, transient network disconnects may cause our gateway to retry a delivery even if your server previously processed it. Your receiver must be idempotent:

Record incoming transaction_id or reference_no in an audit table or Redis lock key with a unique constraint.
If a webhook for an already-completed transaction arrives again, simply return HTTP 200 OK and skip duplicate wallet credits or user SMS dispatches.

3

Never Trust Unverified Webhooks

Never assume an incoming HTTP POST originated from Nepal Recharge just because it has the correct transaction ID. Always compute the HMAC-SHA256 signature using your Webhook Secret Key and execute timing-safe comparison (hash_equals in PHP, crypto.timingSafeEqual in Node.js) to thwart forgery attacks.

4

Mitigate Replay Attacks With Timestamp Windows

Compare the timestamp field against the current server time. If the timestamp is older than 5 minutes (300 seconds), reject the webhook to protect against man-in-the-middle replay attacks.

5

Fallback to Re-Query (Safety Net)

Treat webhooks as the primary, fast notification path. If an execution request returned PENDING and no webhook has arrived within 60 seconds, trigger a single query to GET /api/v1/np/recharge/status?reference_no=... to reconcile the state.

Previous About Webhooks

Next Validate Webhooks

Developer Tools Validate the Webhooks

Validate the Webhooks

Verify cryptographic HMAC-SHA256 signatures to authenticate incoming requests and guarantee data integrity across all 5 programming environments.

Signature Generation Algorithm

The gateway attaches the header X-Webhook-Signature to every delivery. The signature is computed using your account's private Webhook Secret Key:

signature = HMAC_SHA256(raw_http_body, webhook_secret_key)

Important: You must compute the HMAC against the exact raw byte stream of the HTTP request body prior to JSON parsing or decoding.

Verification Implementation

HMAC-SHA256 Signature Verification

# Verify HMAC-SHA256 signature using OpenSSL CLI
SECRET="whsec_YOUR_WEBHOOK_SECRET_KEY"
PAYLOAD='{"event":"recharge.success","timestamp":1759300200,"data":{"transaction_id":"168404550"}}'

# Compute signature
COMPUTED_SIG=$(echo -n "$PAYLOAD" | openssl dgst -sha256 -hmac "$SECRET" | sed 's/^.* //')
echo "Expected Signature: $COMPUTED_SIG"

<?php
// 1. Retrieve the raw HTTP body
$rawPayload = file_get_contents('php://input');

// 2. Read the signature header
$headerSig = $_SERVER['HTTP_X_WEBHOOK_SIGNATURE'] ?? '';
$secret    = 'whsec_YOUR_WEBHOOK_SECRET_KEY';

// 3. Compute expected HMAC-SHA256
$computedSig = hash_hmac('sha256', $rawPayload, $secret);

// 4. Timing-safe comparison
if (!hash_equals($computedSig, $headerSig)) {
    http_response_code(401);
    echo json_encode(['error' => 'Invalid webhook signature']);
    exit;
}

// 5. Parse and handle payload
$event = json_decode($rawPayload, true);
http_response_code(200);
echo json_encode(['status' => 'success']);

<?php
namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Http\JsonResponse;

class WebhookController extends Controller
{
    public function handle(Request $request): JsonResponse
    {
        $signature = $request->header('X-Webhook-Signature');
        $rawContent = $request->getContent();
        $secret = config('services.nepal_recharge.webhook_secret');

        $computed = hash_hmac('sha256', $rawContent, $secret);

        if (!hash_equals($computed, (string)$signature)) {
            return response()->json(['error' => 'Invalid signature'], 401);
        }

        $event = $request->input('event');
        $data  = $request->input('data');

        // Dispatch internal job / queue
        // ProcessWebhookJob::dispatch($event, $data);

        return response()->json(['status' => 'ok'], 200);
    }
}

const crypto = require('crypto');
const express = require('express');
const app = express();

// Capture raw body for signature verification
app.use(express.json({
  verify: (req, res, buf) => {
    req.rawBody = buf;
  }
}));

app.post('/webhook/nepal-recharge', (req, res) => {
  const secret = process.env.WEBHOOK_SECRET || 'whsec_YOUR_WEBHOOK_SECRET_KEY';
  const signature = req.headers['x-webhook-signature'] || '';

  const computed = crypto
    .createHmac('sha256', secret)
    .update(req.rawBody)
    .digest('hex');

  const isValid = crypto.timingSafeEqual(
    Buffer.from(signature, 'utf8'),
    Buffer.from(computed, 'utf8')
  );

  if (!isValid) {
    return res.status(401).json({ error: 'Unauthorized' });
  }

  console.log('Webhook verified:', req.body);
  res.status(200).json({ status: 'success' });
});

import hmac
import hashlib
from flask import Flask, request, jsonify

app = Flask(__name__)
SECRET_KEY = b"whsec_YOUR_WEBHOOK_SECRET_KEY"

@app.route('/webhook/nepal-recharge', methods=['POST'])
def handle_webhook():
    signature = request.headers.get('X-Webhook-Signature', '')
    raw_payload = request.get_data()

    computed_sig = hmac.new(SECRET_KEY, raw_payload, hashlib.sha256).hexdigest()

    # Timing-safe comparison
    if not hmac.compare_digest(computed_sig, signature):
        return jsonify({"error": "Invalid signature"}), 401

    payload = request.get_json()
    print(f"Received event: {payload.get('event')}")

    return jsonify({"status": "ok"}), 200

Previous Webhook Best Practices

Next Webhook Connection

Developer Tools Webhook Connection

Webhook Connection

Configure, test, and monitor your webhook endpoints in the partner merchant portal with IP whitelisting and real-time delivery logs.

Endpoint Setup Guide

1

Provide HTTPS URL

Enter your public, SSL-secured callback endpoint (e.g. https://api.merchant.com/webhook) under Merchant Settings > Webhooks.

2

Save Secret Key

Copy the auto-generated whsec_... secret key and store it securely in your server environment variables.

3

Send Test Ping

Click Send Test Ping to trigger a test event (webhook.test). Check your server logs to verify signature verification succeeds.

Egress Gateway IPs (Firewall Whitelisting)

Gateway Origin	IP Address / Subnet	Port	Protocol
Production Primary Cluster	103.119.144.20	443	HTTPS (TLS 1.2+)
Production Secondary / Failover	103.119.144.21	443	HTTPS (TLS 1.2+)
Sandbox / Staging Cluster	103.119.144.25	443	HTTPS (TLS 1.2+)

Previous Validate Webhooks

Next Service Balance Check

Advance Options Service Balance Check

Service Balance Check

Check real-time available wallet balance, overdraft credit limits, and default commission tiers for your vendor merchant account.

GET /api/v1/wallet/balance

Headers

Field	Type	Status	Description
x-auth-token	string	required	<token>
Accept	string	required	application/json

Request Example

GET /api/v1/wallet/balance

curl -X GET "https://nepalrecharge.com/api/v1/wallet/balance" \
  -H "Accept: application/json" \
  -H "x-auth-token: npr_live_YOUR_API_KEY"

<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL            => 'https://nepalrecharge.com/api/v1/wallet/balance',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'GET',
    CURLOPT_HTTPHEADER     => [
        'Accept: application/json',
        'x-auth-token: npr_live_YOUR_API_KEY'
    ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

<?php
use GuzzleHttp\Client;

$client = new Client([
    'base_uri' => 'https://nepalrecharge.com/api/v1/',
    'timeout'  => 30.0,
]);

$response = $client->get('wallet/balance', [
    'headers' => [
        'Accept'       => 'application/json',
        'x-auth-token' => 'npr_live_YOUR_API_KEY',
    ],
]);

$result = json_decode($response->getBody()->getContents(), true);
print_r($result);

const axios = require('axios');

axios.get('https://nepalrecharge.com/api/v1/wallet/balance', {
  headers: {
    'Accept': 'application/json',
    'x-auth-token': 'npr_live_YOUR_API_KEY'
  }
}).then(res => console.log(res.data))
  .catch(err => console.error(err.response ? err.response.data : err));

import requests

url = "https://nepalrecharge.com/api/v1/wallet/balance"
headers = {
    "Accept": "application/json",
    "x-auth-token": "npr_live_YOUR_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())

Response Examples

200 OK Wallet Balance Data

{
  "status": "success",
  "response_code": 200,
  "message": "Wallet balance retrieved successfully",
  "data": {
    "company_name": "Enterprise Partner Pvt Ltd",
    "currency": "NPR",
    "balance": 85420.50,
    "credit_limit": 100000.00,
    "available_funds": 185420.50,
    "default_commission": 2.50,
    "status": "active"
  }
}

Response Attributes

Field	Type	Description
balance	number	Current deposited prepaid cash balance in NPR.
credit_limit	number	Approved overdraft line granted by admin for high-volume transactions.
available_funds	number	Total spending limit (`balance + credit_limit`) available for recharges.
currency	string	Account billing currency (`NPR`).

Previous Webhook Connection

Next Service Status API

Advance Options Service Status API

Service Status API

Query real-time transaction state, switch confirmation reference, operator response codes, and net financial settlement details using the gateway's unique transaction_id.

GET /api/v1/np/recharge/status/{transactionId}

Headers

Field	Type	Status	Description
x-auth-token	string	required	<token> (Enterprise API Key)
Accept	string	required	application/json

URL / Query Parameters

Parameter	Type	Status	Description
transactionId	string / int	required	The platform gateway transaction ID returned upon recharge execution (e.g. `168404550`). Supported in path or query string.

Status Request Example

GET /api/v1/np/recharge/status/168404550

curl -X GET "https://nepalrecharge.com/api/v1/np/recharge/status/168404550"   -H "Accept: application/json"   -H "x-auth-token: npr_live_YOUR_API_KEY"

<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL            => 'https://nepalrecharge.com/api/v1/np/recharge/status/168404550',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'GET',
    CURLOPT_HTTPHEADER     => [
        'Accept: application/json',
        'x-auth-token: npr_live_YOUR_API_KEY',
    ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

<?php
use GuzzleHttp\Client;

$client = new Client([
    'base_uri' => 'https://nepalrecharge.com/api/v1/',
    'timeout'  => 30.0,
]);

$response = $client->get('np/recharge/status/168404550', [
    'headers' => [
        'Accept'       => 'application/json',
        'x-auth-token' => 'npr_live_YOUR_API_KEY',
    ],
]);

echo $response->getBody();

const axios = require('axios');

async function checkStatus() {
  const res = await axios.get('https://nepalrecharge.com/api/v1/np/recharge/status/168404550', {
    headers: {
      'Accept': 'application/json',
      'x-auth-token': 'npr_live_YOUR_API_KEY'
    }
  });

  console.log(res.data);
}

checkStatus();

import requests

url = "https://nepalrecharge.com/api/v1/np/recharge/status/168404550"
headers = {
    "Accept": "application/json",
    "x-auth-token": "npr_live_YOUR_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())

Response Example (Verified Settlement)

200 OK

JSON Success Payload

{
  "error": false,
  "status": "SUCCESS",
  "message": "Recharge executed successfully",
  "data": {
    "transaction_id": "168404550",
    "reference_no": "ORD-2026-98124",
    "provider_reference": "TXN88219412",
    "provider_payment_id": "NA",
    "operator": "Ncell",
    "mobile_number": "9801037488",
    "amount": 100.00,
    "commission": 2.50,
    "net_deducted": 97.50,
    "status": "SUCCESS",
    "response_code": "00",
    "created_at": "2026-09-30T19:30:00+05:45",
    "updated_at": "2026-09-30T19:30:05+05:45"
  }
}

Response Attributes

Field	Type	Description
transaction_id	string	Numerical transaction identifier issued by the gateway.
reference_no	string	Your unique order reference number provided during the execution step.
provider_reference	string	Upstream carrier or utility board reference STAN identifier.
status	string	`SUCCESS`, `QUEUED`, or `FAILED`.
net_deducted	number	Total NPR deducted from your prepaid balance (face amount minus commission rebate).

Previous Service Balance Check

Next Status by Reference No

Advance Options Status API by Reference No

Status API by Reference No

Retrieve definitive transaction outcomes using your own merchant order reference (reference_no). Essential for network timeout recoveries, client disconnects, and automatic reconciliation.

The Ultimate Network Timeout Recovery Tool

If your server encounters an HTTP 504 Gateway Timeout or a dropped connection during /recharge/execute, you may never receive the gateway's transaction_id. Instead of resubmitting and risking double debits, simply call this endpoint with the same reference_no to safely inspect the final execution result.

GET /api/v1/np/recharge/status?reference_no={reference_no}

Headers

Field	Type	Status	Description
x-auth-token	string	required	<token> (Enterprise API Key)
Accept	string	required	application/json

Query Parameters

Parameter	Type	Status	Description
reference_no	string	required	The merchant order reference passed during initial recharge execution (e.g. `ORD-2026-98124`).

Status by Reference Example

GET /api/v1/np/recharge/status?reference_no=ORD-2026-98124

curl -X GET "https://nepalrecharge.com/api/v1/np/recharge/status?reference_no=ORD-2026-98124"   -H "Accept: application/json"   -H "x-auth-token: npr_live_YOUR_API_KEY"

<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL            => 'https://nepalrecharge.com/api/v1/np/recharge/status?reference_no=ORD-2026-98124',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'GET',
    CURLOPT_HTTPHEADER     => [
        'Accept: application/json',
        'x-auth-token: npr_live_YOUR_API_KEY',
    ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

<?php
use GuzzleHttp\Client;

$client = new Client([
    'base_uri' => 'https://nepalrecharge.com/api/v1/',
    'timeout'  => 30.0,
]);

$response = $client->get('np/recharge/status', [
    'headers' => [
        'Accept'       => 'application/json',
        'x-auth-token' => 'npr_live_YOUR_API_KEY',
    ],
    'query' => [
        'reference_no' => 'ORD-2026-98124',
    ],
]);

echo $response->getBody();

const axios = require('axios');

async function checkStatusByRef() {
  const res = await axios.get('https://nepalrecharge.com/api/v1/np/recharge/status', {
    params: { reference_no: 'ORD-2026-98124' },
    headers: {
      'Accept': 'application/json',
      'x-auth-token': 'npr_live_YOUR_API_KEY'
    }
  });

  console.log(res.data);
}

checkStatusByRef();

import requests

url = "https://nepalrecharge.com/api/v1/np/recharge/status"
headers = {
    "Accept": "application/json",
    "x-auth-token": "npr_live_YOUR_API_KEY"
}
params = {
    "reference_no": "ORD-2026-98124"
}

response = requests.get(url, params=params, headers=headers)
print(response.json())

Response Example (Verified Settlement)

200 OK

JSON Success Payload

{
  "error": false,
  "status": "SUCCESS",
  "message": "Recharge executed successfully",
  "data": {
    "transaction_id": "168404550",
    "reference_no": "ORD-2026-98124",
    "provider_reference": "TXN88219412",
    "provider_payment_id": "NA",
    "operator": "Ncell",
    "mobile_number": "9801037488",
    "amount": 100.00,
    "commission": 2.50,
    "net_deducted": 97.50,
    "status": "SUCCESS",
    "response_code": "00",
    "created_at": "2026-09-30T19:30:00+05:45",
    "updated_at": "2026-09-30T19:30:05+05:45"
  }
}

Response Attributes

Field	Type	Description
reference_no	string	Your unique order reference number.
transaction_id	string	Gateway numerical transaction ID.
provider_reference	string	Upstream carrier or utility board confirmation STAN.
status	string	`SUCCESS`, `QUEUED`, or `FAILED`.
net_deducted	number	Actual NPR deducted from merchant prepaid balance.

Previous Service Status API

Next Overview & Docs Home

Nepal Recharge Mobile Smartcell (Defunct)

Operator Inactive / License Revoked

Smart Telecom – Smartcell (Obsolete)

Smart Telecom Pvt. Ltd. (Smartcell) was previously allocated mobile prefixes 961, 962, and 988 in Nepal.

Regulatory Advisory Notice (NTA)

On April 17, 2023, the Nepal Telecommunications Authority (NTA) cancelled the operating license of Smart Telecom due to non-payment of statutory dues. Smartcell base transceiver stations (BTS) and core switching networks are decommissioned.

All recharge transactions targeting operator_id: 15 will return an explicit HTTP 404/422 status code indicating that the operator is inactive.

API Error Response for Smartcell

{
  "error": true,
  "status": "FAILED",
  "response_code": "404",
  "error_code": "OPERATOR_INACTIVE",
  "field": "operator_id",
  "message": "Smartcell network services are permanently inactive. License revoked by NTA.",
  "data": []
}

Nepal Recharge Travel Bus Booking

Intercity Transit & Ticketing

Nepal Intercity Bus Ticketing API

Unified bus ticketing API for intercity Deluxe, AC, and Sofa Seater buses across all 7 provinces of Nepal.

API Parameters (Operator ID: 119)

Parameter	Type	Required	Description
operator_id	integer	Yes	Must be `119` (Bus Ticketing).
operator_type_id	integer	Yes	Must be `10` (Bus Service).
connection_no	string	Yes	Passenger contact mobile number (10 digits).
amount	numeric	Yes	Total fare in NPR.
reference_no	string	Yes	Unique client booking order ID.

Execute Bus Ticket Booking

curl --request POST   --url https://nepalrecharge.com/api/v1/np/recharge/execute   --header 'Content-Type: application/json'   --header 'x-auth-token: npr_live_YOUR_API_KEY'   --data '{
    "operator_id": 119,
    "operator_type_id": 10,
    "connection_no": "9841234567",
    "amount": 1500.00,
    "reference_no": "BUS-KTM-PKR-9021"
}'

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => 'https://nepalrecharge.com/api/v1/np/recharge/execute',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => json_encode([
    'operator_id' => 119,
    'operator_type_id' => 10,
    'connection_no' => '9841234567',
    'amount' => 1500.00,
    'reference_no' => 'BUS-KTM-PKR-9021'
  ]),
  CURLOPT_HTTPHEADER => [
    'Content-Type: application/json',
    'x-auth-token: npr_live_YOUR_API_KEY'
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

<?php
use GuzzleHttp\Client;
$client = new Client();
$response = $client->post('https://nepalrecharge.com/api/v1/np/recharge/execute', [
  'headers' => [
    'Content-Type' => 'application/json',
    'x-auth-token' => 'npr_live_YOUR_API_KEY',
  ],
  'json' => [
    'operator_id' => 119,
    'operator_type_id' => 10,
    'connection_no' => '9841234567',
    'amount' => 1500.00,
    'reference_no' => 'BUS-KTM-PKR-9021'
  ]
]);
echo $response->getBody();

const axios = require('axios');
axios.post('https://nepalrecharge.com/api/v1/np/recharge/execute', {
  operator_id: 119,
  operator_type_id: 10,
  connection_no: '9841234567',
  amount: 1500.00,
  reference_no: 'BUS-KTM-PKR-9021'
}, {
  headers: {
    'Content-Type': 'application/json',
    'x-auth-token': 'npr_live_YOUR_API_KEY'
  }
}).then(res => console.log(res.data));

import requests
res = requests.post(
  'https://nepalrecharge.com/api/v1/np/recharge/execute',
  headers={
    'Content-Type': 'application/json',
    'x-auth-token': 'npr_live_YOUR_API_KEY'
  },
  json={
    'operator_id': 119,
    'operator_type_id': 10,
    'connection_no': '9841234567',
    'amount': 1500.00,
    'reference_no': 'BUS-KTM-PKR-9021'
  }
)
print(res.json())

India Recharge Lookups Operator Type Lookup

India Catalog

India Operator Type Lookup

Retrieve all active service categories available under the India recharge gateway (Mobile, DTH).

GET /api/v1/in/utility/operators/type

Code Examples

curl --request GET   --url https://nepalrecharge.com/api/v1/in/utility/operators/type   --header 'Accept: application/json'   --header 'x-auth-token: npr_live_YOUR_API_KEY'

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => 'https://nepalrecharge.com/api/v1/in/utility/operators/type',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Accept: application/json',
    'x-auth-token: npr_live_YOUR_API_KEY'
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

<?php
use GuzzleHttp\Client;
$client = new Client();
$response = $client->get('https://nepalrecharge.com/api/v1/in/utility/operators/type', [
  'headers' => [
    'Accept' => 'application/json',
    'x-auth-token' => 'npr_live_YOUR_API_KEY'
  ]
]);
echo $response->getBody();

const axios = require('axios');
axios.get('https://nepalrecharge.com/api/v1/in/utility/operators/type', {
  headers: {
    'Accept': 'application/json',
    'x-auth-token': 'npr_live_YOUR_API_KEY'
  }
}).then(res => console.log(res.data));

import requests
res = requests.get(
  'https://nepalrecharge.com/api/v1/in/utility/operators/type',
  headers={
    'Accept': 'application/json',
    'x-auth-token': 'npr_live_YOUR_API_KEY'
  }
)
print(res.json())

Response Example

{
  "error": false,
  "status": "SUCCESS",
  "response_code": "200",
  "country": "IN",
  "data": [
    { "id": 1, "name": "Mobile", "slug": "mobile" },
    { "id": 2, "name": "DTH", "slug": "dth" }
  ]
}

India Recharge Lookups Operator Lookup

Telecom Operators

India Operator Lookup

Fetch all active Indian Mobile and DTH operators with their slugs and service codes.

GET /api/v1/in/utility/operators

ID	Operator Name	Slug	Service Code	Type
120	Jio Telecom	jio-in	JIO	Mobile
121	Airtel India	airtel-in	AIRTEL	Mobile
122	Vi (Vodafone Idea)	vi-in	VI	Mobile
123	BSNL	bsnl-in	BSNL	Mobile
124	Tata Play (Tata Sky)	tataplay-in	TATAPLAY	DTH

India Recharge Lookups Telecom Circles

Geographic Telecom Regions

India Telecom Circles

Indian mobile operators segment plans and talktime offerings by telecom circle. Pass the circle name when querying packages or executing recharge.

Delhi NCRDelhi

MumbaiMumbai

MaharashtraMaharashtra

KarnatakaKarnataka

Tamil NaduTamil Nadu

UP EastUP East

UP WestUP West

Bihar & JharkhandBihar Jharkhand

KolkataKolkata

West BengalWest Bengal

GujaratGujarat

RajasthanRajasthan

India Recharge Plans Operator Plan Fetch API

Plan Discovery

India Operator Plan Fetch API

Fetch live recharge plans, special unlimited combos, OTT add-ons, and validity packs for Jio, Airtel, Vi, and BSNL.

GET /api/v1/in/packages?operator=jio-in&circle=Delhi

Request Query Parameters

Parameter	Type	Required	Description
operator	string	Yes	Operator slug (e.g. `jio-in`, `airtel-in`, `vi-in`, `bsnl-in`) or ID.
circle	string	Optional	Telecom circle name (e.g. `Delhi`, `Mumbai`, `Bihar Jharkhand`).

Response Structure

{
  "error": false,
  "status": "SUCCESS",
  "country": "IN",
  "count": 24,
  "data": [
    {
      "id": 101,
      "plan_name": "Truly Unlimited 28 Days",
      "package_price": 299.00,
      "validity": "28 Days",
      "data_benefit": "1.5 GB/Day + Unlimited 5G",
      "description": "Unlimited Voice Calls + 100 SMS/Day + JioCinema"
    }
  ]
}

India Recharge DTH Get DTH Bill & Info

DTH Subscription Inquiry

India DTH Customer Info & Bill

Inspect subscriber account status, customer name, and next recharge due date for Tata Play, Airtel DTH, Dish TV, and Sun Direct.

GET /api/v1/in/packages?operator=tataplay-in

India Recharge Execute Recharge Mobile & DTH

Real-Time Execution

Execute India Mobile & DTH Recharge

Instantly execute prepaid mobile recharge and DTH wallet refills across all Indian telecom circles.

POST /api/v1/in/recharge/execute

Field	Type	Required	Description
operator	string	Yes	Operator slug: `jio-in`, `airtel-in`, `vi-in`, `bsnl-in`, or `tataplay-in`.
mobile_number	string	Yes	10-digit Indian mobile number or DTH Subscriber ID.
amount	numeric	Yes	Amount in INR (min 10).
order_id	string	Optional	Unique client reference ID.
circle	string	Optional	Circle name (e.g. `Delhi`, `Mumbai`).

Code Example (5 Languages)

curl --request POST   --url https://nepalrecharge.com/api/v1/in/recharge/execute   --header 'Content-Type: application/json'   --header 'x-auth-token: npr_live_YOUR_API_KEY'   --data '{
    "operator": "jio-in",
    "mobile_number": "9876543210",
    "amount": 299.00,
    "circle": "Delhi",
    "order_id": "IN-ORD-98214"
}'

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => 'https://nepalrecharge.com/api/v1/in/recharge/execute',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => json_encode([
    'operator' => 'jio-in',
    'mobile_number' => '9876543210',
    'amount' => 299.00,
    'circle' => 'Delhi',
    'order_id' => 'IN-ORD-98214'
  ]),
  CURLOPT_HTTPHEADER => [
    'Content-Type: application/json',
    'x-auth-token: npr_live_YOUR_API_KEY'
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

<?php
use GuzzleHttp\Client;
$client = new Client();
$response = $client->post('https://nepalrecharge.com/api/v1/in/recharge/execute', [
  'headers' => [
    'Content-Type' => 'application/json',
    'x-auth-token' => 'npr_live_YOUR_API_KEY',
  ],
  'json' => [
    'operator' => 'jio-in',
    'mobile_number' => '9876543210',
    'amount' => 299.00,
    'circle' => 'Delhi',
    'order_id' => 'IN-ORD-98214'
  ]
]);
echo $response->getBody();

const axios = require('axios');
axios.post('https://nepalrecharge.com/api/v1/in/recharge/execute', {
  operator: 'jio-in',
  mobile_number: '9876543210',
  amount: 299.00,
  circle: 'Delhi',
  order_id: 'IN-ORD-98214'
}, {
  headers: {
    'Content-Type': 'application/json',
    'x-auth-token': 'npr_live_YOUR_API_KEY'
  }
}).then(res => console.log(res.data));

import requests
res = requests.post(
  'https://nepalrecharge.com/api/v1/in/recharge/execute',
  headers={
    'Content-Type': 'application/json',
    'x-auth-token': 'npr_live_YOUR_API_KEY'
  },
  json={
    'operator': 'jio-in',
    'mobile_number': '9876543210',
    'amount': 299.00,
    'circle': 'Delhi',
    'order_id': 'IN-ORD-98214'
  }
)
print(res.json())

Response Structure

{
  "success": true,
  "status": "SUCCESS",
  "response_code": "200",
  "message": "India recharge executed successfully.",
  "data": {
    "transaction_id": "TXN-IN-891024",
    "order_id": "IN-ORD-98214",
    "operator": "Jio Telecom",
    "mobile_number": "9876543210",
    "amount": 299.00,
    "status": "SUCCESS"
  }
}

India Recharge Banking Credit Card Validation

BBPS & Card Settlements

India Credit Card Bill Validation & Payment

Tokenized credit card bill payment and validation compliant with RBI Tokenization and Bharat BillPay guidelines.

Feature Availability & Partner Whitelist

Credit card settlements require verified corporate KYC and a dedicated static IP whitelist. Please contact your account manager or developer support to activate BBPS Credit Card Bill Payments on your vendor token.