Skip to main content
POST
Validate a betting customer

Overview

Ask the biller who owns a customer ID. Show the returned customer_name to the payer and have them confirm it before creating a top-up: a mistyped ID is often someone else’s real account. The ID’s format depends on the biller (SportyBet takes a phone number); a refused ID answers 422 invalid_customer with the biller’s reason in message.

Authorizations

X-API-KEY
string
header
required

API key for authentication.

Body

application/json
biller
string
required

A slug from the biller list.

Example:

"bet9ja"

customer_id
string
required

The customer's ID with the biller. Its format depends on the biller: SportyBet takes a phone number.

Example:

"Hassan3330"

Response

The customer

status
boolean
message
string
error
string[]
data
object