Quicktip

POST `/be/tickets/reserve` endpoint

Reserve quicktip ticket.

Request fields:

Attribute	Data Type	Description
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	quicktip
odds_diff	float	Specifies the max odds deviation when we still accept the request and create the ticket. When the value is set to zero it means we don't allow any odds difference during ticket creation and will respond with "Ticket odds changed" Error response
events	list of objects
events id	integer	Event id
events bet	integer	Event bet id
events odds	float	Event odds at time of ticket submission. Should be in decimal format with 2 digits after comma

Sample request to reserve quickbet ticket:

{
    "operator": "site",
    "token": "sGhx12skwrXsukbZmWh7bkCC9YPEzYQKtKSe9EfCth3Q",
    "price": 2000,
    "currency": "KES",
    "atag": "affiliate-1",
    "source": "mobile",
    "type": "quicktip",
    "odds_diff": 0.7,
    "events": [
        {"id": 390815, "bet": 101, "odds": 1.55},
        {"id": 391814, "bet": 105, "odds": 1.5}
    ]
}

Response fields:

Attribute	Data Type	Description
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
currency	string	Currency code in ISO 4217 three letter format
gross_payout	integer	Ticket gross payout. Should be in integer format (cents). For example, for gross payout 30.45 the value should be 3045
net_payout	integer	Ticket net payout. Should be in integer format (cents). For example, for net payout 30.45 the value should be 3045
wht_amount	integer	Player withholding tax amount. Should be in integer format (cents). For example, for withholding tax amount 30.45 the value should be 3045
wht	float	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)
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	quicktip
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
odds	float	Product of odds for all events for ticket

Sample response (status=200) to quickbet ticket:

{
    "id": "66902628beba20ff2df5c79e",
    "code": "D39163",
    "price": 500,
    "stake": 444,
    "currency": "USD",
    "gross_payout": 2842,
    "net_payout": 2602,
    "wht_amount": 240,
    "wht": 10.0,
    "ext_amount": 56,
    "ext": 12.5,
    "ext_type": "inclusive",
    "status": "reserved",
    "result": "pending",
    "approved": true,
    "source": "desktop",
    "type": "quicktip",
    "atag": "atag_value",
    "user_id": "sometokenvalue",
    "created": "2024-07-11T18:36:24.486000",
    "operator_time_created": "2024-07-11T20:36:24.486000",
    "updated": "2024-07-11T18:36:24.503000",
    "operator_time_updated": "2024-07-11T20:36:24.503000",
    "odds": 6.4
}

Response status codes:

Status Code	Interpretation
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": 104,
    "message": "Events list in ticket object can't be empty"
}

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": 108,
    "message": "Bookmaker event for event with `{event-id}` identifier is not found"
}

Error response (status=400):

{
    "code": 109,
    "message": "Market is blocked"
}

Error response (status=400):

{
    "code": 110,
    "message": "Ticket odds changed"
}

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"
}