> 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. # Commit prize payout POST https://v1/api/pos/countries/EC/sales/payouts/commit Content-Type: application/json # Commit prize payout (FR32) Pay the prize. Requires `Idempotency-Key`. `amount` **must** equal quote. At least one of `ticketId` / `publicCode`. **Beneficiary** (v1 default required: `fullName`, `idNumber`; operator may require `contact`, `address`). Stored append-only. Already paid → `409 already-paid`. **201:** `payoutId`, `status` `completed` or `pending`. ## 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/payouts/commit-prize-payout ## 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. - `amount` (string, required) - `currency` (string, required) - `ticketId` (string, required) - `beneficiary` (V1ApiPosCountriesEcSalesPayoutsCommitPostRequestBodyContentApplicationJsonSchemaBeneficiary, 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) ## Types ### V1ApiPosCountriesEcSalesPayoutsCommitPostRequestBodyContentApplicationJsonSchemaBeneficiary - `address` (string, required) - `contact` (string, required) - `fullName` (string, required) - `idNumber` (string, required) ## Examples **Request** ```json { "amount": "25.00", "currency": "USD", "ticketId": "0193a0d0-aaaa-7f11-9a22-4b8c1d2e3f50", "beneficiary": { "address": "Av. 9 de Octubre, Guayaquil", "contact": "+593990000000", "fullName": "Ana Pérez", "idNumber": "0912345678" } } ``` **SDK Code** ```python Sales_Payouts_Commit prize payout_example import requests url = "https://https/v1/api/pos/countries/EC/sales/payouts/commit" payload = { "amount": "25.00", "currency": "USD", "ticketId": "0193a0d0-aaaa-7f11-9a22-4b8c1d2e3f50", "beneficiary": { "address": "Av. 9 de Octubre, Guayaquil", "contact": "+593990000000", "fullName": "Ana Pérez", "idNumber": "0912345678" } } 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_Payouts_Commit prize payout_example const url = 'https://https/v1/api/pos/countries/EC/sales/payouts/commit'; 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: '{"amount":"25.00","currency":"USD","ticketId":"0193a0d0-aaaa-7f11-9a22-4b8c1d2e3f50","beneficiary":{"address":"Av. 9 de Octubre, Guayaquil","contact":"+593990000000","fullName":"Ana Pérez","idNumber":"0912345678"}}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Sales_Payouts_Commit prize payout_example package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://https/v1/api/pos/countries/EC/sales/payouts/commit" payload := strings.NewReader("{\n \"amount\": \"25.00\",\n \"currency\": \"USD\",\n \"ticketId\": \"0193a0d0-aaaa-7f11-9a22-4b8c1d2e3f50\",\n \"beneficiary\": {\n \"address\": \"Av. 9 de Octubre, Guayaquil\",\n \"contact\": \"+593990000000\",\n \"fullName\": \"Ana Pérez\",\n \"idNumber\": \"0912345678\"\n }\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_Payouts_Commit prize payout_example require 'uri' require 'net/http' url = URI("https://https/v1/api/pos/countries/EC/sales/payouts/commit") 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 \"amount\": \"25.00\",\n \"currency\": \"USD\",\n \"ticketId\": \"0193a0d0-aaaa-7f11-9a22-4b8c1d2e3f50\",\n \"beneficiary\": {\n \"address\": \"Av. 9 de Octubre, Guayaquil\",\n \"contact\": \"+593990000000\",\n \"fullName\": \"Ana Pérez\",\n \"idNumber\": \"0912345678\"\n }\n}" response = http.request(request) puts response.read_body ``` ```java Sales_Payouts_Commit prize payout_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/payouts/commit") .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 \"amount\": \"25.00\",\n \"currency\": \"USD\",\n \"ticketId\": \"0193a0d0-aaaa-7f11-9a22-4b8c1d2e3f50\",\n \"beneficiary\": {\n \"address\": \"Av. 9 de Octubre, Guayaquil\",\n \"contact\": \"+593990000000\",\n \"fullName\": \"Ana Pérez\",\n \"idNumber\": \"0912345678\"\n }\n}") .asString(); ``` ```php Sales_Payouts_Commit prize payout_example request('POST', 'https://https/v1/api/pos/countries/EC/sales/payouts/commit', [ 'body' => '{ "amount": "25.00", "currency": "USD", "ticketId": "0193a0d0-aaaa-7f11-9a22-4b8c1d2e3f50", "beneficiary": { "address": "Av. 9 de Octubre, Guayaquil", "contact": "+593990000000", "fullName": "Ana Pérez", "idNumber": "0912345678" } }', '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_Payouts_Commit prize payout_example using RestSharp; var client = new RestClient("https://https/v1/api/pos/countries/EC/sales/payouts/commit"); 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 \"amount\": \"25.00\",\n \"currency\": \"USD\",\n \"ticketId\": \"0193a0d0-aaaa-7f11-9a22-4b8c1d2e3f50\",\n \"beneficiary\": {\n \"address\": \"Av. 9 de Octubre, Guayaquil\",\n \"contact\": \"+593990000000\",\n \"fullName\": \"Ana Pérez\",\n \"idNumber\": \"0912345678\"\n }\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Sales_Payouts_Commit prize payout_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 = [ "amount": "25.00", "currency": "USD", "ticketId": "0193a0d0-aaaa-7f11-9a22-4b8c1d2e3f50", "beneficiary": [ "address": "Av. 9 de Octubre, Guayaquil", "contact": "+593990000000", "fullName": "Ana Pérez", "idNumber": "0912345678" ] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://https/v1/api/pos/countries/EC/sales/payouts/commit")! 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() ```