BBPS & Utility · BBPS Bill Services

BBPS Bill Payment

Pay utility bill instantly. Debits developer wallet balance atomically and executes through InsPay BBPS.

POST request

URL: https://api.payorbit.in/api/v1/bbps/bill-pay

Body

{
    "amount": 1450,
    "canumber": "100123456",
    "latitude": "28.6139",
    "operator": "BSE000001DEL01",
    "longitude": "77.2090",
    "reference_id": "TXN_BBPS_847291"
}

Include a valid Bearer token with every request

Success response

{
    "fee": 0,
    "amount": 1450,
    "status": "success",
    "message": "Bill paid successfully",
    "operator_ref": "INS8923145",
    "balance_after": 8550,
    "transaction_id": "BBPS2026100112345678"
}

Failure response

{
    "status": "error",
    "message": "Request failed. Check credentials, wallet balance, or validation errors."
}

Overview

Execute instant BBPS bill payment. Amount is debited atomically from developer's wallet balance. If operator rejects or fails, instant refund is issued.

Header: Authorization: Bearer {token}

Body

application/json required

Schema

{
    "type": "object",
    "required": [
        "operator",
        "canumber",
        "amount",
        "reference_id"
    ],
    "properties": {
        "amount": {
            "type": "number",
            "description": "Amount to pay in INR"
        },
        "canumber": {
            "type": "string",
            "description": "Consumer number / Account number"
        },
        "latitude": {
            "type": "string",
            "description": "Terminal / Agent geo latitude"
        },
        "operator": {
            "type": "string",
            "description": "Biller ID or operator code"
        },
        "longitude": {
            "type": "string",
            "description": "Terminal / Agent geo longitude"
        },
        "reference_id": {
            "type": "string",
            "description": "Unique transaction reference ID from developer"
        }
    }
}

Example

{
    "amount": 1450,
    "canumber": "100123456",
    "latitude": "28.6139",
    "operator": "BSE000001DEL01",
    "longitude": "77.2090",
    "reference_id": "TXN_BBPS_847291"
}

Responses

200 · application/json

Successful operation

Example

{
    "fee": 0,
    "amount": 1450,
    "status": "success",
    "message": "Bill paid successfully",
    "operator_ref": "INS8923145",
    "balance_after": 8550,
    "transaction_id": "BBPS2026100112345678"
}