Recharge & Bill Payments

Recharge Complaint API

POST /api/v1/mobile-recharge/recharge-complaint

The Recharge Complaint from JustSwitch lets product teams recharge mobile recharge data in real time through a single REST integration. Designed for the Prepaid / Postpaid lane, it removes manual checks, reduces drop-offs in onboarding funnels, and returns structured JSON that your risk engine, CRM, or core banking system can consume instantly.

Real-time recharge for mobile recharge data with sub-300ms median latency
Production-grade REST JSON with sandbox & webhook support
UIDAI / NPCI / MCA aligned partner routing where applicable
Audit logs, idempotency keys & enterprise SLA on JustSwitch

Get API keys Developer docs

200 OK

{
  "ok": true,
  "data": {
    "status": "success"
  }
}

REST JSON HTTPS Live

Latency: 400–800 ms
Uptime SLA: 99.9%
Format: REST / JSON
Sandbox: Included

What is Recharge Complaint?

Every request is authenticated with API keys, logged for audit, and routed through regulated partner rails where required. Responses follow a consistent `{ ok, data, message }` envelope so you can ship once and reuse the same error-handling patterns across all JustSwitch endpoints.

Recharge APIs return operator, circle, plan metadata, and live status — ideal for retailer apps, super-apps, and white-label distributors.

Developers choose JustSwitch for Recharge Complaint because we aggregate multiple upstream providers behind one contract, one wallet settlement, and one support desk — so you launch faster while your compliance team retains full audit visibility through dashboard logs and exportable reports.

Retail POS Super apps Distributors Fintech wallets

Technical specification

Endpoint details for Recharge Complaint integration on JustSwitch.

POST /api/v1/mobile-recharge/recharge-complaint

Protocol	HTTPS REST / JSON
Authentication	Bearer API Key + IP allow-list
Sandbox	Available — no live debits
Median latency	400–800 ms
Rate limits	Burst-friendly — contact for enterprise tiers
Webhooks	Yes — signed callbacks
Idempotency	Supported via idempotency_key
API slug	recharge-complaint

Request parameters

reference_id string required

Your unique transaction or session reference for reconciliation

consent boolean required

User consent flag — required for regulated KYC / verification flows

amount number required

Recharge amount in INR

operator string required

Operator code from lookup API

Response fields

status string

success | pending | failed

reference_id string

Echo of your request reference

verified_at datetime

ISO-8601 timestamp of completion

txn_id string

JustSwitch transaction identifier

utr string

Bank / NPCI reference when available

message string

Human-readable result or error detail

Key features

REST + JSON

HTTPS POST/GET with UTF-8 JSON bodies and predictable status codes.

Sandbox mode

Test end-to-end without debiting wallet or hitting live rails.

Webhooks

Async callbacks for pending states — payments, recharge, KYC, payouts.

Dashboard logs

Searchable request history with filters for support & audits.

Low latency

Median sub-300 ms for verification-class endpoints in production.

Enterprise SLA

99.9% uptime target with redundant routing and monitoring.

Who uses Recharge Complaint?

Retailer apps

POS recharge & bill pay with commission tracking.

Super apps

Embed utilities inside loyalty & wallet experiences.

Fintech wallets

Cross-sell bill payments to improve retention.

B2B distributors

White-label APIs for downstream agents.

How it works

01
Obtain sandbox keys from the JustSwitch developer console.
02
POST input identifiers; handle validation errors in-line.
03
Map response fields into your workflow & go live with production keys.

Sample integration

Illustrative JSON for Recharge Complaint — see developer docs for live schemas.

POST Request

{
    "mobile": "9876543210",
    "operator": "jio",
    "circle": "delhi",
    "amount": 299
}

200 Response

{
    "ok": true,
    "message": "Success",
    "data": {
        "status": "success",
        "reference_id": "JS-MJBD2VY7",
        "verified_at": "2026-06-23T22:50:20+00:00"
    }
}

Business benefits

Reduce manual ops cost by up to 70% on verification-heavy journeys
Improve conversion with inline validation instead of offline turnaround
Single contract & settlement across 200+ Indian fintech APIs
Audit-ready logs exported from the admin console
Dedicated solutions engineering for enterprise rollouts

Frequently asked questions

What is Recharge Complaint used for?

It automates Prepaid / Postpaid workflows so your application can verify or transact in real time without building direct integrations with multiple upstream providers.

How do I integrate Recharge Complaint in my app?

Sign up on JustSwitch, obtain sandbox API keys, call the REST endpoint with JSON body, handle the unified response envelope, then switch to production keys after UAT sign-off.

How do I authenticate requests?

Use Bearer API keys from the JustSwitch dashboard. Sandbox and production keys are separated; rotate keys anytime without downtime.

Is there a sandbox for testing?

Yes — every API supports sandbox mode with simulated responses so engineering, QA, and compliance can sign off before go-live.

What about webhooks and async status?

Long-running operations (payments, recharge, some KYC steps) emit webhooks to your HTTPS endpoint with signed payloads for replay protection.

Is Recharge Complaint compliant for regulated use in India?

JustSwitch routes requests through authorised AUA/KUA, NPCI, MCA and partner networks. Your legal team should map consent, data retention and licence obligations to your use case.

Related Prepaid / Postpaid APIs

Explore more endpoints in the same verification category.

Prepaid Mobile Recharge

The Prepaid Mobile Recharge from JustSwitch lets product teams recharge mobile numbers in real time through a single REST integration. Desig...

View API details →

Postpaid Bill Payment

The Postpaid Bill Payment from JustSwitch lets product teams pay mobile recharge data in real time through a single REST integration. Design...

View API details →

Prepaid Recharge Status

The Prepaid Recharge Status from JustSwitch lets product teams recharge mobile recharge data in real time through a single REST integration....

View API details →

Recharge Transaction Status

The Recharge Transaction Status from JustSwitch lets product teams recharge mobile recharge data in real time through a single REST integrat...

View API details →

Recharge Refund

The Recharge Refund from JustSwitch lets product teams recharge mobile recharge data in real time through a single REST integration. Designe...

View API details →

Recharge Reversal

The Recharge Reversal from JustSwitch lets product teams recharge mobile recharge data in real time through a single REST integration. Desig...

View API details →

Start building with Recharge Complaint

Sandbox keys in minutes. Production access with compliance review for regulated endpoints.

Create free account Browse Prepaid / Postpaid