Skip to main content
POST
Create a betting top-up

Overview

Debit your NGN wallet amount + fee and top up the customer’s betting wallet. Amounts are ₦100 to ₦500,000. reference must be unique across your business; retry a timed-out request with the same reference, never a new one. The request answers 202 with status: processing; the outcome arrives as bill.success, bill.failed or bill.reversed. See Betting top-ups.

Authorizations

X-API-KEY
string
header
required

API key for authentication.

Body

application/json
biller
string
required
Example:

"bet9ja"

customer_id
string
required
Example:

"Hassan3330"

amount
number
required

NGN, from 100 to 500,000.

Example:

1000

reference
string
required

Your reference, unique across your business. Retry a timed-out request with the same one.

Maximum string length: 100
Example:

"order-1042"

customer_name_confirmation
string

The name the payer confirmed. Refused with customer_name_mismatch if it does not match the biller's.

Example:

"HASSANA SAIDU"

Response

Processing

status
boolean
message
string
error
string[]
data
object