Bill payments

Beyond data and airtime, Plustive pays four kinds of bills: cable TV, electricity, education PINs, and broadband. They all share one shape: list products → (verify the customer) → pay. Money is in kobo, and every purchase is idempotent via your clientReference.

The flow

1. List products for the service — e.g. GET /v1/cabletv/products. Each product has a planId you pass when paying. Products you can see are gated to what's enabled for your account.
2. Verify the customer identifier (cable TV, electricity, broadband) — e.g. POST /v1/cabletv/verify. You get back the account holder's customerName and a status of valid, invalid, or unknown. Verifying first lets you confirm you're paying the right account. Education has no verify step.
3. Pay — e.g. POST /v1/cabletv. The response is the same PurchaseResponse you know from data/airtime.

Identifiers per service

Service	Identifier field	Verify?	Amount
Cable TV	smartcard	yes	fixed (from the product)
Electricity	meterNumber	yes	variable — you send amountKobo (min ₦100)
Broadband	accountNumber	yes	fixed
Education	phoneNumber (optional)	no	fixed

Tokens and PINs

When a purchase vends a value — an electricity prepaid token or an education PIN — it comes back in the token field of the buy response, and it's re-fetchable any time via GET /v1/transactions/{reference}. For data, airtime and cable TV, token is null.

Variable amount (electricity)

Electricity has no fixed price — you choose amountKobo (minimum ₦100). We add a small markup to compute the wallet charge; the priceCharged in the response is what was debited.