Skip to navigation
Lucky-Tom POS APISalesPayouts

Commit prize payout

View as Markdown

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.

Headers

X-Lucky-Tom-Partner-IdstringOptional

Public partner id. Required (AND). Not a secret.

X-Lucky-Tom-TimestampstringOptional

Unix ms. Pre-request Script overwrites on Send.

X-Lucky-Tom-SignaturestringOptional

HMAC-SHA256 hex. Pre-request Script overwrites on Send.

Idempotency-KeystringOptional
Required on this mutation. Not in the HMAC canonical string.

Request

This endpoint expects an object.
amountstringRequired
currencystringRequired
ticketIdstringRequiredformat: "uuid"
beneficiaryobjectRequired

Errors

401
Unauthorized Error
422
Unprocessable Entity Error