> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://pos-api-docs.lucky-tom.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://pos-api-docs.lucky-tom.com/_mcp/server. # Create ticket (Bingo Tom) POST https://v1/api/pos/countries/EC/sales/tickets#postV1ApiPosCountriesEcSalesTickets3 Content-Type: application/json # Create ticket — Bingo Tom (FR29) Requires `Idempotency-Key`. Body: `productCode: bingo_tom`, `sessionId` (status `sales`), `quantity`, and exactly one of `cardIds` (specific unsold cards) or `quickAssign: true` (CSPRNG). Cards gone / quantity too high → `422 cards-unavailable`. Session not in sales → `422 sales-closed`. ## Authentication (AND, not OR) Partner-Id + Bearer `client_secret` + Timestamp + Signature. See **Authentication**. 401 unauthorized · 422 hmac-invalid · 422 hmac-skew · 403 country-mismatch. Reference: https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/sales/tickets/create-ticket-bingo-tom ## Request ### Headers - `X-Lucky-Tom-Partner-Id` (string, optional) — Public partner id. Required (AND). Not a secret. - `X-Lucky-Tom-Timestamp` (string, optional) — Unix ms. Pre-request Script overwrites on Send. - `X-Lucky-Tom-Signature` (string, optional) — HMAC-SHA256 hex. Pre-request Script overwrites on Send. - `Idempotency-Key` (string, optional) — Required on this mutation. Not in the HMAC canonical string. ### Body (application/json) This endpoint expects an object. - `quantity` (integer, required) - `sessionId` (string, required) - `productCode` (string, required) - `quickAssign` (boolean, required) ## Errors ### 401 Unauthorized Error Unauthorized - `type` (string, required) - `title` (string, required) - `detail` (string, required) - `status` (integer, required) ### 422 Unprocessable Entity Error Unprocessable Entity - `type` (string, required) - `title` (string, required) - `detail` (string, required) - `status` (integer, required) ## Examples **Request** ```json { "quantity": 2, "sessionId": "0193a0c2-2222-7f11-9a22-4b8c1d2e3f42", "productCode": "bingo_tom", "quickAssign": true } ``` **SDK Code** ```python Sales_Tickets_Create ticket (Bingo Tom)_example import requests url = "https://https/v1/api/pos/countries/EC/sales/tickets#postV1ApiPosCountriesEcSalesTickets3" payload = { "quantity": 2, "sessionId": "0193a0c2-2222-7f11-9a22-4b8c1d2e3f42", "productCode": "bingo_tom", "quickAssign": True } headers = { "Idempotency-Key": "{{$guid}}", "X-Lucky-Tom-Partner-Id": "{{partnerId}}", "X-Lucky-Tom-Signature": "set-by-pre-request", "X-Lucky-Tom-Timestamp": "set-by-pre-request", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Sales_Tickets_Create ticket (Bingo Tom)_example const url = 'https://https/v1/api/pos/countries/EC/sales/tickets#postV1ApiPosCountriesEcSalesTickets3'; const options = { method: 'POST', headers: { 'Idempotency-Key': '{{$guid}}', 'X-Lucky-Tom-Partner-Id': '{{partnerId}}', 'X-Lucky-Tom-Signature': 'set-by-pre-request', 'X-Lucky-Tom-Timestamp': 'set-by-pre-request', 'Content-Type': 'application/json' }, body: '{"quantity":2,"sessionId":"0193a0c2-2222-7f11-9a22-4b8c1d2e3f42","productCode":"bingo_tom","quickAssign":true}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Sales_Tickets_Create ticket (Bingo Tom)_example package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://https/v1/api/pos/countries/EC/sales/tickets#postV1ApiPosCountriesEcSalesTickets3" payload := strings.NewReader("{\n \"quantity\": 2,\n \"sessionId\": \"0193a0c2-2222-7f11-9a22-4b8c1d2e3f42\",\n \"productCode\": \"bingo_tom\",\n \"quickAssign\": true\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Idempotency-Key", "{{$guid}}") req.Header.Add("X-Lucky-Tom-Partner-Id", "{{partnerId}}") req.Header.Add("X-Lucky-Tom-Signature", "set-by-pre-request") req.Header.Add("X-Lucky-Tom-Timestamp", "set-by-pre-request") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Sales_Tickets_Create ticket (Bingo Tom)_example require 'uri' require 'net/http' url = URI("https://https/v1/api/pos/countries/EC/sales/tickets#postV1ApiPosCountriesEcSalesTickets3") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Idempotency-Key"] = '{{$guid}}' request["X-Lucky-Tom-Partner-Id"] = '{{partnerId}}' request["X-Lucky-Tom-Signature"] = 'set-by-pre-request' request["X-Lucky-Tom-Timestamp"] = 'set-by-pre-request' request["Content-Type"] = 'application/json' request.body = "{\n \"quantity\": 2,\n \"sessionId\": \"0193a0c2-2222-7f11-9a22-4b8c1d2e3f42\",\n \"productCode\": \"bingo_tom\",\n \"quickAssign\": true\n}" response = http.request(request) puts response.read_body ``` ```java Sales_Tickets_Create ticket (Bingo Tom)_example import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://https/v1/api/pos/countries/EC/sales/tickets#postV1ApiPosCountriesEcSalesTickets3") .header("Idempotency-Key", "{{$guid}}") .header("X-Lucky-Tom-Partner-Id", "{{partnerId}}") .header("X-Lucky-Tom-Signature", "set-by-pre-request") .header("X-Lucky-Tom-Timestamp", "set-by-pre-request") .header("Content-Type", "application/json") .body("{\n \"quantity\": 2,\n \"sessionId\": \"0193a0c2-2222-7f11-9a22-4b8c1d2e3f42\",\n \"productCode\": \"bingo_tom\",\n \"quickAssign\": true\n}") .asString(); ``` ```php Sales_Tickets_Create ticket (Bingo Tom)_example request('POST', 'https://https/v1/api/pos/countries/EC/sales/tickets#postV1ApiPosCountriesEcSalesTickets3', [ 'body' => '{ "quantity": 2, "sessionId": "0193a0c2-2222-7f11-9a22-4b8c1d2e3f42", "productCode": "bingo_tom", "quickAssign": true }', 'headers' => [ 'Content-Type' => 'application/json', 'Idempotency-Key' => '{{$guid}}', 'X-Lucky-Tom-Partner-Id' => '{{partnerId}}', 'X-Lucky-Tom-Signature' => 'set-by-pre-request', 'X-Lucky-Tom-Timestamp' => 'set-by-pre-request', ], ]); echo $response->getBody(); ``` ```csharp Sales_Tickets_Create ticket (Bingo Tom)_example using RestSharp; var client = new RestClient("https://https/v1/api/pos/countries/EC/sales/tickets#postV1ApiPosCountriesEcSalesTickets3"); var request = new RestRequest(Method.POST); request.AddHeader("Idempotency-Key", "{{$guid}}"); request.AddHeader("X-Lucky-Tom-Partner-Id", "{{partnerId}}"); request.AddHeader("X-Lucky-Tom-Signature", "set-by-pre-request"); request.AddHeader("X-Lucky-Tom-Timestamp", "set-by-pre-request"); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"quantity\": 2,\n \"sessionId\": \"0193a0c2-2222-7f11-9a22-4b8c1d2e3f42\",\n \"productCode\": \"bingo_tom\",\n \"quickAssign\": true\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Sales_Tickets_Create ticket (Bingo Tom)_example import Foundation let headers = [ "Idempotency-Key": "{{$guid}}", "X-Lucky-Tom-Partner-Id": "{{partnerId}}", "X-Lucky-Tom-Signature": "set-by-pre-request", "X-Lucky-Tom-Timestamp": "set-by-pre-request", "Content-Type": "application/json" ] let parameters = [ "quantity": 2, "sessionId": "0193a0c2-2222-7f11-9a22-4b8c1d2e3f42", "productCode": "bingo_tom", "quickAssign": true ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://https/v1/api/pos/countries/EC/sales/tickets#postV1ApiPosCountriesEcSalesTickets3")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```