Superbet

POST `/be/tickets/reserve` endpoint

Reserve superbet ticket.

Request fields:

AttributeData TypeDescription

operator

string

Name of the operator as registered on the system

token

string

Player identification token

price

integer

Ticket price. Should be in integer format (cents). For example, for price 35.00 the value will be 3500

currency

string

Currency code in ISO 4217 three letter format

atag

string or null

Optional affiliate Tag or Affiliate ID. If parameter is present then it is added to the ticket_reserve PAM API call.

source

string

Ticket source (see Fields)

type

string

superbet Ticket Type (see Fields)

event

integer

Event id

bets

list of integers

Each element is event bet id

Sample request to reserve superbet ticket:

{
    "operator": "site",
    "token": "sGhx12skwrXsukbZmWh7bkCC9YPEzYQKtKSe9EfCth3Q",
    "price": 2000,
    "currency": "KES",
    "atag": "affiliate-1",
    "source": "mobile",
    "type": "superbet",
    "event": 100001,
    "bets": [101, 102, 103, 104, 105, 106]
}

Response fields:

AttributeData TypeDescription

id

string

Ticket id

code

string

Ticket code

price

integer

Ticket price. Should be in integer format (cents). For example, for price 35.00 the value will be 3500

stake

integer

Ticket amount. Should be in integer format (cents). For example, for stake 30.45 the value should be 3045

gross_payout

integer

Ticket gross payout. Should be in integer format (cents). Will always be 0

net_payout

integer

Ticket net payout. Should be in integer format (cents). Will always be 0

wht_amount

integer

Player withholding tax amount. Should be in integer format (cents). Will always be 0

wht

integer

Player withholding tax percentage. For example, for withholding tax percentage 20.0% the value should be 20.0

ext_amount

integer

Ticket exercise tax amount. Should be in integer format (cents). For example, for exercise tax amount 1.25 the value will be 125

ext

float

Ticket exercise tax percentage. For example, for exercise tax percentage 12.5% the value should be 12.5

ext_type

string

Exercise tax type (see Fields)

currency

string

Currency code in ISO 4217 three letter format

status

string

Ticket Status (see Fields)

result

string

Ticket Result (see Fields)

approved

bool

Ticket approval (see Fields)

source

string

Ticket source (see Fields)

type

string

superbet Ticket Type (see Fields)

atag

string

Optional affiliate Tag or Affiliate ID. If parameter is present then it is added to the ticket_reserve PAM API call.

user_id

string

User ID from PAM

created

string

Ticket created datetime, UTC. Format - 2024-01-28T14:33:01.000000

operator_time_created

string

Ticket created datetime, operator timezone. Format - 2024-01-28T14:33:01.000000

updated

string

Ticket updated datetime, UTC. Format - 2024-01-28T14:33:01.000000

operator_time_updated

string

Ticket updated datetime, operator timezone. Format - 2024-01-28T14:33:01.000000

Sample response (status=200) to superbet ticket:

{
    "id": "66902734beba20ff2df5c79f",
    "code": "DEC4C0",
    "price": 1000,
    "stake": 889,
    "gross_payout": 0,
    "net_payout": 0,
    "wht_amount": 0,
    "wht": 10.0,
    "ext_amount": 111,
    "ext": 12.5,
    "ext_type": "inclusive",
    "currency": "USD",
    "status": "reserved",
    "result": "pending",
    "approved": true,
    "source": "desktop",
    "type": "superbet",
    "atag": "atag_value",
    "user_id": "token_i",
    "created": "2024-07-11T18:40:52.995000",
    "operator_time_created": "2024-07-11T20:40:52.995000",
    "updated": "2024-07-11T18:40:53.013000",
    "operator_time_updated": "2024-07-11T20:40:53.013000"
}

Response status codes:

Status CodeInterpretation

200

OK - Everything worked as expected

400

Bad Request. Please check error code in response body (see Error codes)

403

Forbidden. You do not have access for such request

422

Validation Error. Please check response body for more details

Error response (status=400):

{
    "code": 103,
    "message": "Event with `{event-id}` identifier is not found"
}

Error response (status=400):

{
    "code": 105,
    "message": "Team with `{team-id}` identifier is not found"
}

Error response (status=400):

{
    "code": 106,
    "message": "Market for bet with `{market-id}` identifier is not found"
}

Error response (status=400):

{
    "code": 107,
    "message": "Event with `{event-id}` identifier is not available for play because it has already started"
}

Error response (status=400):

{
    "code": 111,
    "message": "Duplicate key for code generation"
}

Error response (status=400):

{
    "code": 112,
    "message": "Operator with `{operator-id}` name is not found"
}

Error response (status=400):

{
    "code": 114,
    "message": "No webhook url for operator with `{operator-id}` name"
}

Error response (status=400):

{
    "code": 115,
    "message": "Operators in request body and in request header are not identical"
}

Error response (status=400):

{
    "code": 116,
    "message": "Market with `{market-id}` code is not allowed"
}

Last updated