Integrate seamless utility bill payment services for electricity, water, gas, and more with our robust API. Offer instant bill payments with the highest commissions in the industry.
We support all major utility bill payment services in India
All major electricity providers
Municipal water corporations
PNG and LPG gas providers
Internet and broadband services
Powerful features designed for seamless integration
Bill payments are processed within seconds with 99.9% success rate
Bank-grade security with end-to-end encryption for all transactions
Earn up to 4% commission on every bill payment transaction
Simple REST API with comprehensive documentation and SDKs
Get your commissions settled daily to your bank account
Dedicated technical support team available round the clock
Comprehensive guide to integrate our utility bill payment API
POST https://a1topup.com/api/v1/bill-payment
Parameter | Type | Required | Description |
---|---|---|---|
api_key | String | Yes | Your unique API key |
bill_type | String | Yes | Type of bill (ELECTRICITY, WATER, GAS, BROADBAND) |
provider | String | Yes | Provider code (e.g., TATA_POWER, DELHI_JAL, INDANE) |
consumer_id | String | Yes | Consumer number/account number |
amount | Number | Yes | Bill payment amount |
fetch_bill | Boolean | No | Set to true to fetch bill details before payment |
{
"api_key": "your_api_key_here",
"bill_type": "ELECTRICITY",
"provider": "TATA_POWER",
"consumer_id": "TP123456789",
"amount": 1250.50,
"fetch_bill": true
}
{
"status": "success",
"transaction_id": "TXN123456789",
"message": "Bill payment successful",
"amount": 1250.50,
"commission": 37.52,
"balance": 9542.50,
"due_date": "2023-12-15",
"bill_period": "NOV-2023"
}
Parameter | Type | Description |
---|---|---|
status | String | Request status (success/error) |
transaction_id | String | Unique transaction ID for reference |
message | String | Response message |
amount | Number | Payment amount |
commission | Number | Commission earned on this transaction |
balance | Number | Your current wallet balance |
due_date | String | Bill due date (if fetched) |
bill_period | String | Billing period (if fetched) |
Error Code | Message | Description |
---|---|---|
1101 | Invalid API key | The provided API key is invalid or disabled |
1102 | Insufficient balance | Your wallet doesn't have enough balance |
1103 | Invalid consumer ID | The consumer ID format is incorrect |
1104 | Invalid provider | The provider code is not recognized |
1105 | Invalid bill type | The bill type is not supported |
1106 | Bill already paid | This bill has already been paid |
2101 | Provider system down | The provider's system is temporarily unavailable |
{
"status": "error",
"error_code": "1102",
"message": "Insufficient balance",
"required_amount": 1250.50,
"current_balance": 1000.00
}
Choose the plan that works best for your business
Sign up today and get your API keys to start integrating utility bill payment services.