Subscribe Plan for Subscription Option
Subscribe Plan for Subscription Option
API Documentation
Introduction
LiveREST JSONVitalDeW Recharge API lets you integrate mobile/DTH/BBPS recharges, check status, and receive callbacks. All endpoints are HTTPS POST/GET JSON with Api-Id/Api-Key headers. Base URL is common for all.
Test Mode: Use
/webservices/api/test prefix with Test Keys from — no real money deducted.Base URL & Headers
Required Headers (every request)
| Header | Value | Where to get |
|---|---|---|
Api-Id | VDW-AUTO-8F3K9X2P | API Settings API Documentation |
Api-Key | sk_live_51Hx...9x2P | → Generate |
Content-Type | application/json | Always |
x-auth-id* | 9713785786 | Login mobile (for dashboard APIs) |
/v1/* (dashboard) APIs, also send x-auth-id/x-auth-token from /v1/auth/login.
POST /v1/auth/login — Get Token
Login to get token for dashboard APIs. Public recharge APIs use Api-Id/Key only.
POST /v1/auth/login
Content-Type: application/json
{
"loginType": "Password",
"mobileNumber": "9713785786",
"password": "your_password"
}
{
"status": "success",
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"data": { "id": 149, "mobileNumber": 9713785786, "accountsRole": "apiUsers" }
}
GET /v1/public/recharge Main (POST bhi supported)
Initiate recharge. Use valid amounts only (see Valid Amounts).
Request
curl "https://autonew.vitaldew.in/v1/public/recharge?apiid=[apiid]&apikey=[apikey]&number=[number]&operator=[operator]&amount=[amount]&field1=[field1]&field2=[field2]&field3=[field3]&field4=[field4]&refnumber=[refnumber]"
Alternative POST (with headers)
curl -X POST https://autonew.vitaldew.in/v1/public/recharge -H "Api-Id: VDW-AUTO-8F3K9X2P" -H "Api-Key: sk_live_..." -H "Content-Type: application/json" -d '{"number":"9713785786","amount":199,"operator":"JIO","referenceId":"ORDER12345"}'
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
apiid | String | Yes | API Settings page se mila API ID |
apikey | String | Yes | API Settings page se mila API Key |
number | String | Yes | Recharge mobile / account number |
operator | Number | Yes | Operator id (Operator list API se lein — e.g. 2 = Jio) |
amount | Number | Yes | Recharge amount (aapke margin range ke andar hona chahiye) |
refnumber | String | Yes | Aapka unique transaction reference — status check & dispute me kaam aata hai |
field1 | String | No | Refer your commission Package |
field2 | String | No | Refer your commission Package |
field3 | String | No | Refer your commission Package |
field4 | String | No | Refer your commission Package |
Operator id ke liye Operators API call karo — waha se
id milega (e.g. Jio=2, Airtel=3).Response
Response Type : JSON
{
"status": "Success/Failure/Pending",
"message": "Information",
"transactionsid": "Our Transactiond Id",
"number": "Recharge Number",
"amount": "Amount",
"commission": "Recharge Commission",
"balance": "Accounts Balance",
"operatorsid": "Operator Id",
"operatorName": "Operator Name (e.g. Jio Recharge)",
"refnumber": "your transaction id"
}
Pending recharges update via Callback within 2 mins.
GET /v1/public/recharge-status
Check status by transactionsid or refnumber (one required).
curl "https://autonew.vitaldew.in/v1/public/recharge-status?apiid=[apiid]&apikey=[apikey]&transactionsid=[transactionsid]&refnumber=[refnumber]"
| Parameter | Type | Required |
|---|---|---|
| apiid | String | Yes |
| apikey | String | Yes |
| transactionsid | Number | No* (one of this/refnumber) |
| refnumber | String | No* (one of this/transactionsid) |
{ "status": "Success", "message": "Transaction Information", "transactionsid": "56", "number": "9876543210", "amount": 10, "commission": 0.5, "operatorsid": "BR00012345A", "refnumber": "VD202608191234" }
Client Status Check (by your refnumber)
curl "https://autonew.vitaldew.in/v1/public/client-recharge-status?apiid=[apiid]&apikey=[apikey]&refnumber=[refnumber]"
Dashboard (with token)
GET /v1/transactions/?transactionsId=TXN...
-H "x-auth-id: 9713785786" -H "x-auth-token: ..."
-H "x-auth-id: 9713785786" -H "x-auth-token: ..."
GET /v1/public/balance-check
curl "https://autonew.vitaldew.in/v1/public/balance-check?apiid=[apiid]&apikey=[apikey]"
{ "status": "success", "balance": 12450.75, "currency": "INR" }
For dashboard wallet (with login), use GET /v1/dashboard/stats-new with x-auth-id/x-auth-token headers.
GET /webservices/api/operators
curl https://autonew.vitaldew.in/webservices/api/operators -H "Api-Id: 2X3HgUri" -H "Api-Key: gqwQAo4EkNU6dCil"
| Operator ID | Code | Name | Category |
|---|---|---|---|
| 1 | AT | Airtel | Mobile |
| 4 | RJ | Jio Recharge | Mobile |
| 6 | VI | Vodafone | Mobile |
| 2 | BS | BSNL Special | Mobile |
| 3 | BT | BSNL Talk Time | Mobile |
| 64 | ADT | Airtel Digital TV | DTH |
| 65 | DT | Dish TV | DTH |
| 66 | TP | Tata Play | DTH |
| 67 | VD | Videocon d2h | DTH |
| 68 | SD | Sun Direct | DTH |
operator param me ye ID bhejo (e.g. operator=4 for Jio, 6 for Vodafone).
Full list: GET /v1/recharge-configurations/operators (with auth).
History & Reports
| Endpoint | Method | Use |
|---|---|---|
/v1/transactions/?pageNumber=1&recordsPerPage=20 | GET | Recharge history (filters: number, transactionsStatus, startDate, endDate) |
/v1/transactions/api-call-logs | GET | API call logs |
/v1/reports/operator-day-book?date=2026-08-31 | GET | Operator day book |
/v1/reports/api-summary-book?date=... | GET | API summary |
GET /v1/public/raise-transaction-dispute Dispute
Raise a complaint for a successful transaction.
curl "https://autonew.vitaldew.in/v1/public/raise-transaction-dispute?apiid=[apiid]&apikey=[apikey]&transactionsid=[transactionsid]"
curl "https://autonew.vitaldew.in/v1/public/raise-transaction-dispute?apiid=[apiid]&apikey=[apikey]&refnumber=[refnumber]"
| Parameter | Type | Required |
|---|---|---|
| apiid | String | Yes |
| apikey | String | Yes |
| transactionsid | Number | Yes* |
| refnumber | String | Yes* |
* Provide either transactionsid OR refnumber (at least one required)
{ "status": "Success", "message": "Complaint Reopened Successfully" }
Callback (Webhook)
Set your Callback URL in API Settings API Documentation. We POST final status there.
POST {yourCallbackUrl}
Content-Type: application/x-www-form-urlencoded
txnId=TXN2026831001&status=success&amount=199&operatorRef=JIO199...&referenceId=ORDER12345
// Your server should respond within 5s:
HTTP/1.1 200 OK
OK
We retry 3 times on failure (exponential backoff). Check Callback Logs.
Error Codes
| HTTP | Code | Message | Fix |
|---|---|---|---|
| 200 | success | Recharge successful | - |
| 200 | pending | Pending | Wait for callback / checkStatus |
| 401 | Unauthorized | Invalid Api-Id/Key or IP not whitelisted | Check Keys & IP in Settings |
| 400 | Invalid Amount | Amount not in valid slabs | See Valid Amounts |
| 404 | Operator not found | Wrong operator code | Use /operators |
| 402 | Insufficient Balance | Wallet empty | Recharge wallet |
| 429 | Rate Limited | Too many requests | Retry after 60s |
| 500 | Failed | Operator failed | Retry or check logs |