OuiPay
API ReferenceServices

Supported networks

Operators per service and market : networks, billers, and exam bodies you can sell.

Operators resolve live per country through GET /v1/services/{code}/operators. The endpoint is authoritative: the tables below show the networks the platform routes today so you can scope a build, but always pass the code the endpoint returns for that country.

Do not hardcode operator codes

Operator codes are identifiers on the routed fulfilment rail for the country: the same network can carry different codes across markets or after a rail change. Resolve them from /operators at checkout time, and treat this page as a coverage reference, not a code table.

Nigeria (NG)

Airtime and data

codeNetwork
mtnMTN
airtelAirtel
gloGlobacom
etisalat9mobile

Data plans load per operator from /plans with category and validity normalized (daily, weekly, monthly, others).

Electricity

Metered bills: every DisCo accepts meter_type prepaid or postpaid (see /variants) and meter numbers validate through /validate.

codeDistribution company
ikeja-electricIkeja Electric (IKEDC)
eko-electricEko Electricity (EKEDC)
abuja-electricAbuja Electricity (AEDC)
enugu-electricEnugu Electricity (EEDC)
portharcourt-electricPort Harcourt Electricity (PHEDC)
ibadan-electricIbadan Electricity (IBEDC)
kano-electricKano Electricity (KEDCO)
kaduna-electricKaduna Electric (KAEDC)
jos-electricJos Electricity (JED)
benin-electricBenin Electricity (BEDC)
aba-electricAba Power (APLE)
yola-electricYola Electricity (YEDC)

TV

codeProvider
dstvDStv
gotvGOtv
startimesStarTimes
showmaxShowmax

Bouquets load per operator from /plans: pass the plan code as product_code on the order. Smartcard numbers validate via /validate.

Education

codeBody
waecWAEC result checker PIN
jambJAMB e-PIN
nabtebNABTEB result checker PIN

Internet

The internet catalogue resolves live: Smile, Spectranet, Swift, and ipNX broadband subscriptions appear when the rail returns them. Codes on this rail use the provider's biller identifiers: always read them from /operators, never assume the vtpass-style slugs used elsewhere.

Insurance, gift cards, betting, water

ServiceCoverage
insuranceInsurer catalogue resolves live per country
gift_cardsDigital brands resolve live; feature-flagged rollout
bettingRail pending activation: not executable today
waterNo live rail yet: the tile may render but orders are not executable

Ghana (GH)

ServicecodeNetwork
airtimemtn-ghMTN Ghana
airtimevodafone-ghTelecel Ghana
airtimetigo-ghAirtelTigo
datamtn-ghMTN Ghana
datavodafone-ghTelecel Ghana
datatigo-ghAirtelTigo
dataglo-ghGlo Ghana
electricityresolves liveUtility billers per /operators

GH data plans price per destination: pass phone to /plans so the catalogue returns the bundles for that number's network.

Benin (BJ)

Airtime, data, and electricity fulfil through the international top-up rail: the operator catalogue (MTN Benin, Moov Benin, and utility billers) resolves live via /operators?country=BJ.

A network you need is missing

Coverage is configuration, not code: a missing operator usually means the rail does not carry it for that country, not that the API cannot route it. Check /operators for the service country first, then raise the gap with your OuiPay contact: new billers go live without an API change.