Instant Top-Ups
Process recharges instantly across Jio, Airtel, Vi, and BSNL networks with execution times under 3 seconds.
Instant Telecom Top-Up Gateway
Process top-ups via Mobile Recharge API.
Connect your retail or fintech platform to all major cellular networks. Fetch dynamic plan lists, trigger instant recharges, track operator references, and manage commissions from a single integration.
- v2.0
- < 50ms
- < 3s
Recharge Gateway
● Online (v2.0)POST /api/v2/recharge/exec HTTP/1.1Host: console.devsecit.comAuthorization: Bearer DSI_REC_...Content-Type: application/json// Request Payload{ "operator_code": "JIO", "mobile": "9876543210", "amount": 299.00}
⚡ 3-Second Execution🔒 PCI-DSS Compliant
Capabilities
2. Mobile Recharge Features
Dynamic Plan Fetching
Retrieve up-to-date plan lists, including talktime, data limits, validity, and special offers, directly from operators.
DTH & Cable Top-Ups
Recharge DTH plans across Tata Play, Dish TV, Airtel Digital TV, Sun Direct, and Videocon d2h operators.
Commission Management
Set custom commission margins for each operator and track earnings automatically on our dashboard.
Platform architecture
1. Platform Overview & Business Architecture
The Mobile Recharge API is a high-speed telecommunications integration gateway. Interfacing with individual mobile networks, DTH providers, and utility billers to manage top-ups, dynamic plan lists, and transaction commissions is a significant development bottleneck. This API solves this by offering a standardized, real-time middleware layer that coordinates operator APIs, billing balances, and commissions.
Using our API, developers can check active plans and validity for any mobile number; query available top-up amounts; execute instant recharges; track operator transaction reference codes; and manage reseller commissions.
Security is critical for payment networks. The API uses secure OAuth2 authentication tokens and HTTPS/TLS 1.3 encryption to protect user identities and transaction details in compliance with data privacy regulations.
API reference
3. API Reference & Technical Endpoints
The API operates over secure HTTPS. Below are the request and response configurations for executing mobile recharges.
HTTP Request (POST)EXECUTE RECHARGE
POST https://console.devsecit.com/api/v2/recharge/exec Header "Authorization: Bearer YOUR_RECHARGE_KEY" Header "Content-Type: application/json"
Request Payload (Body JSON)
{
"operator_code": "JIO",
"circle_code": "KOLKATA",
"mobile": "9876543210",
"amount": 299.00,
"client_reference_id": "cli_txn_98273"
}Successful Response Payload (200 OK)
{
"status": "success",
"recharge_id": "rec_89271ac092",
"operator_reference_id": "OPJIO89172839201",
"mobile": "9876543210",
"amount": 299.00,
"commission_earned": 8.97,
"balance_remaining": 15430.50
}Plan verification
4. Dynamic Plan Verification & Fetch Flow
To prevent incorrect recharges, our gateway validates plan details dynamically:
How it works:
- Operator Lookups: When a user enters their mobile number, the API performs an operator and circle lookup to determine the correct network provider.
- Plan Queries: The engine queries active catalog databases to list valid talktime and data packs for that operator.
- Price Validations: If the client selects a plan, the system verifies the recharge amount to prevent operator rejections.
API Documentation
Mobile Recharge API
- Jio, Airtel, Vi, BSNL, major DTH boards
- < 50ms
- < 3 Seconds to operator network
Security
5. Security, Wallet Vaulting & Transaction Safeties
Processing transaction recharges requires maintaining high security and reliability standards:
Double-Spend Prevention
Our database uses transaction locks to prevent double-spending or duplicate debit attempts.
Encrypted Wallets
Reseller wallet balances are encrypted and stored in secure database tables, protected from unauthorized changes.
API Endpoint Security
Requests are signed with client credentials. Tunnels use HTTPS/TLS 1.3 to protect transaction payloads.
Failover Routes
If an operator's primary route experiences downtime, the system automatically redirects requests through backup routes.
Enterprise use cases
6. Enterprise Use Cases
Retail Recharge Outlets
Power brick-and-mortar retail outlets, allowing agents to execute instant mobile and DTH recharges for walk-in customers.
Mobile Wallet Integrations
Integrate mobile and DTH recharges directly into consumer digital wallet applications.
Corporate Expense Management
Automate monthly mobile recharges for corporate employees, with direct limit configurations and invoicing.
The numbers
What the recharge gateway actually guarantees
Latency, execution speed, limits and coverage as published for the Mobile Recharge API.
- < 50ms
- < 3 seconds
- 60 calls/min
- Jio, Airtel, Vi, BSNL
Developer portal measurement for the recharge endpoint.
Execution time through to the operator network.
Production environments scale to high-volume transaction traffic.
Plus Tata Play, Dish TV, Airtel Digital TV, Sun Direct and Videocon d2h.
Questions
7. FAQ & Troubleshooting Guide
What happens if a recharge transaction fails?
If a transaction fails at the operator's end, the locked funds are automatically refunded to your developer wallet balance.
How do we fetch DTH customer details?
You can fetch DTH customer names, active plans, and balances by calling the customer info endpoint with the client's subscriber ID.
What is the settlement timeframe for reseller commissions?
Reseller commissions are calculated and credited to your wallet balance instantly upon successful completion of each transaction.
What is the rate limit for mobile recharges?
Sandbox environments support up to 60 calls/minute, while production environments scale to support high-volume transaction traffic.
Get started
Deploy Instant Recharge Gateways
Get your developer credentials, configure reseller commission structures, and integrate secure mobile recharges today.