Bill Payment · BBPS

BBPS Status

Check BBPS transaction status

GET request

URL: https://uat-api.vizodigital.com/api/v1/bill-payment/bbps/status

Include a valid Bearer token with every request

Code sample

curl -X GET "https://uat-api.vizodigital.com/api/v1/bill-payment/bbps/status?orderid=BBPS_PAY_001" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Success response

{
    "status": "success",
    "message": "Status retrieved.",
    "data": {
        "orderid": "BBPS_PAY_001",
        "local": {
            "type": "bbps_pay",
            "status": "success",
            "amount": 1240.5,
            "opcode": "BRPL",
            "consumer_number": "1001234567",
            "fetch_id": "BBPSF-12-ab12cd34",
            "provider_txid": "OP998877",
            "utr": null,
            "error_message": null
        },
        "provider": {
            "status": "Success",
            "message": "Transaction Successful"
        }
    }
}

Failure response

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

Overview

Look up a BBPS transaction by orderid. Returns local ledger status and best-effort provider status.

Responses

200 · application/json default

Status payload

Example

{
    "status": "success",
    "message": "Status retrieved.",
    "data": {
        "orderid": "BBPS_PAY_001",
        "local": {
            "type": "bbps_pay",
            "status": "success",
            "amount": 1240.5,
            "opcode": "BRPL",
            "consumer_number": "1001234567",
            "fetch_id": "BBPSF-12-ab12cd34",
            "provider_txid": "OP998877",
            "utr": null,
            "error_message": null
        },
        "provider": {
            "status": "Success",
            "message": "Transaction Successful"
        }
    }
}

Rate Limits

60/min