Skip to main content
Fund customer accounts on major Nigerian betting platforms.

​
Get Betting Billers

Retrieve the list of supported betting platforms. 
GET /api/v1/business/vas/betting/billers
Signature required: Yes

​
Request example

curl -X GET "https://api-dev.usenumero.com/numeroaccount/api/v1/business/vas/betting/billers" \
  -H "x-api-key: your_api_key" \
  -H "x-signature-key: generated_signature"

​
Response

{
  "status": true,
  "message": "Successful",
  "code": "200",
  "data": {
    "billers": [
      {
        "itemCode": "BET9JA",
        "itemName": "Bet9ja",
        "category": "betting"
      },
      {
        "itemCode": "SPORTYBET",
        "itemName": "SportyBet",
        "category": "betting"
      }
    ]
  }
}

​
Validate Betting Account

Verify a customer’s betting account before funding. 
POST /api/v1/business/vas/betting/validate
Signature required: Yes

​
Request body

FieldTypeRequiredDescription
typestringYesBetting platform code (from billers list)
customerIdstringYesCustomer’s betting account ID

​
Request example

curl -X POST "https://api-dev.usenumero.com/numeroaccount/api/v1/business/vas/betting/validate" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key" \
  -H "x-signature-key: generated_signature" \
  -d '{
    "type": "BET9JA",
    "customerId": "12345678"
  }'

​
Response

{
  "status": true,
  "message": "Successful",
  "code": "200",
  "data": {
    "message": "Validation successful",
    "data": {
      "customerName": "John Doe",
      "customerId": "12345678"
    }
  }
}

​
Fund Betting Account

Deposit funds into a validated betting account. 
POST /api/v1/business/vas/betting/fund
Signature required: Yes

​
Request body

FieldTypeRequiredDescription
referencestringYesYour unique transaction reference
typestringYesBetting platform code
customerIdstringYesCustomer’s betting account ID
namestringYesCustomer’s name
amountnumberYesAmount in Naira

​
Request example

curl -X POST "https://api-dev.usenumero.com/numeroaccount/api/v1/business/vas/betting/fund" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key" \
  -H "x-signature-key: generated_signature" \
  -d '{
    "reference": "BET-20240115-001",
    "type": "BET9JA",
    "customerId": "12345678",
    "name": "John Doe",
    "amount": 2000
  }'

​
Response

{
  "status": true,
  "message": "Successful",
  "code": "200",
  "data": {
    "message": "Funding successful",
    "reference": "BET-20240115-001",
    "data": {
      "customerId": "12345678",
      "amount": 2000
    }
  }
}