Bill Payments

Pay supported bills by posting the customer or account identifier and the bill product code (nw). The API accepts the request and processes it asynchronously; final status is delivered to your callback URL.

Endpoint

POST https://api.bridgeagw.com/pay_bill

Request Headers

Authorization: Basic <base64_encoded_credentials>
Content-Type: application/json

Request Body

{
  "service_id": 55,
  "reference": "Bill payment",
  "transaction_id": "ksnyew2kei4a-alnlapk-uou",
  "trans_type": "BLP",
  "amount": 5,
  "account_number": "3928978903232",
  "nw": "EPP",
  "callback_url": "https://webhook.site/0b429e73-ce5c-420b-af82-a346fb577c43",
  "request_time": "2025-10-03 23:50"
}

Parameters

Parameter	Type	Required	Description
`service_id`	integer	Yes	Your service identifier
`reference`	string	Yes	Payment reference or description
`transaction_id`	string	Yes	Unique transaction identifier
`trans_type`	string	Yes	Must be `BLP` for bill payment
`amount`	number	Yes	Payment amount
`account_number`	string	Yes	Customer or account number for the bill
`nw`	string	Yes	Bill product code (see table below)
`callback_url`	string	Yes	URL for asynchronous status notifications
`request_time`	string	Yes	Request timestamp

Supported bill products (`nw`)

Code	Service
`GOT`	GoTV
`GTM`	GoTV Max
`DST`	DSTv
`MPO`	MTN Postpaid
`MPP`	MTN Prepaid Data
`VPO`	Vodafone Postpaid
`VPP`	Vodafone Prepaid Data
`SFL`	Surfline
`TLS`	Telesol
`STT`	Startimes
`ECG`	ECG Postpaid
`VBB`	Vodafone Broadband (ADSL)
`BXO`	Box Office
`EPP`	ECG Prepaid
`GHW`	Ghana Water
`SCP`	School Placement
`WRE`	WAEC Result

Response

Accepted (202)

{
  "response_message": "Request successfully received for processing",
  "response_code": "202"
}

Example (cURL)

curl -X POST "https://api.bridgeagw.com/pay_bill" \
  -H "Authorization: Basic <your_credentials>" \
  -H "Content-Type: application/json" \
  -d '{
    "service_id": 55,
    "reference": "Bill payment",
    "transaction_id": "ksnyew2kei4a-alnlapk-uou",
    "trans_type": "BLP",
    "amount": 5,
    "account_number": "3928978903232",
    "nw": "EPP",
    "callback_url": "https://your-site.com/webhook/bill-status",
    "request_time": "2025-10-03 23:50"
  }'

Callbacks

After you receive 202, rely on your callback_url for final status. See Callbacks.

Bill Payments

On this page