Skip to main content
POST
Vend betting via parent account
This endpoint is deprecated. Use Vend betting via parent account (v2) at POST /v2/bill/betting instead.
Always requery the transaction using Fetch a single transaction on the parent account to confirm its final status before issuing a refund. Only refund if data.status is REFUND.
For a complete guide on response codes and transaction statuses, see Response Codes.

Authorizations

Authorization
string
header
required

Nomba authenticates API calls with OAuth2 HTTP bearer tokens. There are two methods of authentication; Client-Credentials method and PKCE (Proof Key for Code Exchange) method. In each of the methods, You will get an ACCESS_TOKEN. You need to use an "Authorization" HTTP header to provide your ACCESS_TOKEN. For example: Authorization: {ACCESS_TOKEN}.

Headers

accountId
string<uuid>
required

The parent accountId of the business.

Example:

"890022ce-bae0-45c1-9b9d-ee7872e6ca27"

Body

application/json

The request payload required to vend betting

bettingProvider
string
Example:

"bet9ja"

merchantTxRef
string

This is an idempotency key and must be unique per transaction.

Example:

"12345"

phoneNumber
string
Example:

"09012345678"

payerName
string
Example:

"John Doe"

amount
integer
Example:

1000

customerId
string
Example:

"customer123"

Response

OK - your request was successful.

code
string
required

Response Code

Example:

"00"

description
string
required

Response description

Example:

"Success"

data
object
required