Skip to main content
POST
Validate Customer Identifier
Validates a customer’s recipient identifier before initiating a payment. This verifies that the recipient account exists, belongs to the correct tariff, and returns customer name and outstanding balances.

Common Validation Use Cases

  1. Electricity Meters: Verify prepaid or postpaid meter number against DisCo databases before vending energy units.
  2. Cable TV Smartcards: Validate IUC/Smartcard numbers against MultiChoice/StarTimes to retrieve customer name, current bouquet, and due date.
  3. Education / Exam Portals: Validate student matriculation or registration numbers for tuition and exam fee settlements.
  4. Betting Accounts: Confirm player user ID before wallet funding.

Authorizations

Authorization
string
header
default:sk_test_handle_master_key
required

Supply your secret API key (e.g. sk_live_... or sk_test_...) in the Authorization header.

Body

application/json
category
enum<string>
default:GOVERNMENT
required
Available options:
GOVERNMENT,
ELECTRICITY,
AIRTIME,
DATA,
INTERNET,
CABLE_TV,
UTILITIES,
EDUCATION,
FLIGHTS,
BETTING,
GAMING,
SOLAR,
TRANSPORT,
ESIM,
TAXES,
HOSPITALS,
INSURANCE,
RELIGIOUS,
ASSOCIATIONS,
FINANCIAL_SERVICES,
CREDIT_LOANS,
MICRO_PENSIONS,
INVOICE,
GIFT_CARDS,
SHOPPING,
FOOD_DINING,
LIFESTYLE_BEAUTY,
HOME_LIVING
Example:

"GOVERNMENT"

billerCode
string
default:FRSC
required
Example:

"FRSC"

recipientId
string
default:KJA-829-AA
required
Example:

"KJA-829-AA"

params
object

Optional parameters (e.g. billPaymentProductId for Government/Remita, or meterType for Electricity)

Response

200 - application/json

Customer verification details

isValid
boolean
Example:

true

customerName
string
Example:

"ADEWALE AYODEJI PETERS"

address
string
Example:

"14 ADEOLA ODEKU STREET, VICTORIA ISLAND, LAGOS"

meterNumber
string
Example:

"0219927013063"

billerCode
string
Example:

"AEDC"

outstandingAmount
number
Example:

0

metadata
object