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
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
atag	string	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",
    "stake": 500,
    "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
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
payout	integer	Ticket payout. Should be in integer format (cents). For example, for payout 30.45 the value should be 3045
tax	integer	Player withholding tax. Should be in integer format (cents). For example, for tax 30.45 the value should be 3045
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
updated	string	Ticket updated datetime
odds	float	Product of odds for all events for ticket

Sample response (status=200) to quickbet ticket:

{
    "id": "6314704d686a9e8e5d68dca6",
    "code": "E36E20",
    "stake": 500,
    "currency": "KES",
    "odds": 2.325,
    "tax": 1162,
    "payout": 1112,
    "status": "reserved",
    "result": "pending",
    "approved": true,
    "source": "mobile",
    "type": "quicktip",
    "atag": "affiliate-1",
    "user_id": "1660986605374148608",
    "created": "2022-01-04T09:30:53",
    "updated": "2022-09-04T09:30:53",
    "odds": 1.45
}

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 `390815` identifier is not found"
}

Error response (status=400):

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