The Dramepe API
REST endpoints for bill payments, recharges, status and complaints. JSON in, JSON out, a sandbox to test against, and webhooks for every change in status.
Authentication
Bearer API keys, separate for sandbox and live, restricted to your whitelisted server IPs.
Idempotency
Every payment carries your ref_id. A repeated reference returns the original result instead of paying again.
Webhooks
Signed callbacks on success, failure and reversal. Verify the signature with your webhook secret.
Status API
Pending payments can be checked any time — don’t retry a payment whose status is unknown.
What you can call
Base URLs, request schemas and error codes are in the full reference, shared with partners at onboarding.
| Method | Path | Purpose |
|---|---|---|
| GET | /v1/bbps/billers | List billers by category, with the input fields each one needs |
| POST | /v1/bbps/bill/fetch | Fetch the outstanding bill for a customer |
| POST | /v1/bbps/bill/validate | Validate customer inputs for billers without bill fetch |
| POST | /v1/bbps/bill/pay | Pay a bill |
| GET | /v1/transactions/{ref_id} | Get the current status of any transaction |
| POST | /v1/bbps/complaints | Raise a Bharat Connect complaint |
| GET | /v1/bbps/complaints/{id} | Track a complaint |
| POST | /v1/recharge/mobile | Prepaid mobile recharge |
| GET | /v1/recharge/plans | Plans for an operator and circle |
| POST | /v1/recharge/dth | DTH recharge |
| GET | /v1/wallet/balance | Current wallet balance |
Know the moment status changes
We POST a JSON event to your URL whenever a transaction settles. Respond with HTTP 200; we retry with back-off if you don’t.
- transaction.success — biller or operator confirmed
- transaction.failed — rejected; amount reversed to wallet
- transaction.reversed — a pending payment was later reversed
- complaint.updated — a complaint moved to a new status
// X-Dramepe-Signature: sha256=… { "event": "transaction.success", "ref_id": "PAY-20260916-0001", "bbps_ref": "CC016259XXXXXXXX", "service": "BBPS", "amount": 1846.00, "status": "SUCCESS", "timestamp": "2026-09-16T11:42:08+05:30" }
Illustrative payload. Field list is final in the partner reference.