Bill payments overview

Breeze supports three bill products on the same external transactions API as airtime and data:

Product	Guide	`customer_msisdn` holds
`ELECTRICITY`	Electricity	Meter number (prepaid or postpaid)
`CABLE`	Cable TV	Smartcard / IUC number
`BETTING`	Betting	Betting customer / account ID


POST /ext/breeze/v1/transactions

Create is async on /ext/breeze/v1 — poll status with your client_request_id.

Plan catalogs


GET /ext/breeze/v1/plans/bills/{product}

{product} is electricity, cable, or betting. Optional ?network= filter (e.g. IKEDC, DSTV, BET9JA).


curl "https://staging-intelligent-70287b6a3284.herokuapp.com/ext/breeze/v1/plans/bills/cable?network=DSTV" \
  -H "X-Merchant-Key: mk_live_your_key_id" \
  -H "X-Merchant-Secret: sk_live_your_secret"

Pass the returned plan id as plan_code on purchase.

Verify customer (optional)

Verification runs automatically before purchase. Optional pre-check on the platform API (Bearer token):


POST /v1/transactions/verify


{
  "product": "ELECTRICITY",
  "network": "IKEDC",
  "msisdn": "45012345678",
  "plan": "1001"
}

No request_id on verify.

Status and history


GET /ext/breeze/v1/transactions/status/{client_request_id}
GET /ext/breeze/v1/transactions?page=1&limit=20

Bill rows use product values ELECTRICITY, CABLE, or BETTING.

Contact your account manager to enable each bill product on your merchant profile.