v1

latestOpenAPI 3.0.12026-07-2679100267.2 KB

Betting Vending

Vend betting via parent account

You can use this endpoint to vend betting via parent account

post/v1/bill/betting

Headers

accountIdstring uuid required

Example:890022ce-bae0-45c1-9b9d-ee7872e6ca27

The parent accountId of the business.

Request body

bettingProviderstring

merchantTxRefstring

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

phoneNumberstring

payerNamestring

amountinteger

customerIdstring

Example request

{
  "bettingProvider": "bet9ja",
  "merchantTxRef": "12345",
  "phoneNumber": "09012345678",
  "payerName": "John Doe",
  "amount": 1000,
  "customerId": "customer123"
}

Response

OK - your request was successful.

codestring required

Response Code

descriptionstring required

Response description

Example response

{
  "code": "00",
  "description": "Success",
  "data": {
    "amount": 2000,
    "timeCreated": "2023-09-04T07:09:06.900Z",
    "type": "phcn",
    "meta": {
      "merchantTxRef": "test1116",
      "rrn": "240626232937",
      "api_client_id": "123456-9100-4e66-93e1-7f6da894ef89",
      "api_account_id": "0167288-d989-460a-bbde-9842f2b4320f"
    },
    "status": "SUCCESS",
    "id": "SUCCESS",
    "fee": "0.0"
  }
}