curl --location POST \
--url https://api.nomba.com/v1/bill/betting \
--header 'accountId: <accountId>' \
--header 'Authorization: Bearer <token>' \
    --data '{
        "bettingProvider": "bet9ja",
        "merchantTxRef": "c006475e-a76f-4533-b2ff-59a67d5e6241",
        "phoneNumber":"09012345678",
        "payerName": "John Doe",
        "amount": 2000,
        "customerId": "1234567890"
    }'
{
    "code": "00",
    "description": "SUCCESS",
    "data": {
        "amount": 2000,
        "meta": {
            "merchantTxRef": "c006475e-a76f-4533-b2ff-59a67d5e6241",
            "api_client_id": "10422171-9100-4e66-93e1-7f6da894ef89",
            "api_account_id": "01a10aeb-d989-460a-bbde-9842f2b4320f",
            "rrn": "240809060134"
        },
        "fee": "",
        "timeCreated": "2024-08-09T05:01:35.014Z",
        "id": "API-BETTING-4B8C8-dcc5994c-e110-4035-9017-fc6e497a3baa",
        "type": "betting",
        "status": "SUCCESS"
    }
}

POST /v1/bill/betting

Request body

amount
integer
required

Amount

bettingProvider
string
required

Betting provider’s id (e.g. bet9ja, betKing, scratch2win etc) - This id can be gotten from doing a fetch of available providers

merchantTxRef
string
required

Merchant Transaction Reference (a unique reference to identify this transaction on your system)

payerName
string
required

The name of the person to be attached to this transaction

customerId
string
required

An unique id to identify the customer to which this payment belongs. This should be same as verified in the lookup api

phoneNumber
string
required

The phone number of the person to be attached to this transaction

Response body

code
string
required

Response code

description
string
required

Response description

data
object
curl --location POST \
--url https://api.nomba.com/v1/bill/betting \
--header 'accountId: <accountId>' \
--header 'Authorization: Bearer <token>' \
    --data '{
        "bettingProvider": "bet9ja",
        "merchantTxRef": "c006475e-a76f-4533-b2ff-59a67d5e6241",
        "phoneNumber":"09012345678",
        "payerName": "John Doe",
        "amount": 2000,
        "customerId": "1234567890"
    }'
{
    "code": "00",
    "description": "SUCCESS",
    "data": {
        "amount": 2000,
        "meta": {
            "merchantTxRef": "c006475e-a76f-4533-b2ff-59a67d5e6241",
            "api_client_id": "10422171-9100-4e66-93e1-7f6da894ef89",
            "api_account_id": "01a10aeb-d989-460a-bbde-9842f2b4320f",
            "rrn": "240809060134"
        },
        "fee": "",
        "timeCreated": "2024-08-09T05:01:35.014Z",
        "id": "API-BETTING-4B8C8-dcc5994c-e110-4035-9017-fc6e497a3baa",
        "type": "betting",
        "status": "SUCCESS"
    }
}