> 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/lucky-tom-pos-api/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.

# Overview

# Lucky-Tom POS API

Partner backends and POS terminals. Sister collection: **Lucky-Tom Casino** (Team Workspace) — Game Provider inbound HMAC + SeamlessWallet outbound (no HMAC).

Open **Authentication** first. Auth is **AND, not OR**: Partner-Id + Bearer `client_secret` + HMAC (`hmacSecretKey`) on every request.

Canonical string: `{METHOD}\n{pathAndQuery}\n{timestamp}\n{sha256HexOfRawBody}`

Empty body SHA-256 is always `e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855`. Clock skew ±5 minutes → `422 hmac-skew`. Identity failure → `401 unauthorized`. Signature failure → `422 hmac-invalid`.

This collection's Pre-request Script signs `/v1/api/pos/` only when `hmacSecretKey` is set. Timestamp and Signature headers are placeholders; Send overwrites them.

Select environment **Lucky Tom UAT** or **Lucky Tom Production**. Fill `partnerId`, `clientSecret`, `hmacSecretKey`.

Do not Send the Authentication documentation request. Postman Authorization tab is unused on purpose (AND, not OR).

## Docs

- [Overview](https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/authentication.md)
- [Overview](https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/wallets.md)
- [Overview](https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/wallets/top-ups.md)
- [Overview](https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/wallets/withdrawals.md)
- [Overview](https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/sales.md)
- [Overview](https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/sales/tickets.md)
- [Overview](https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/sales/payouts.md)
- [Overview](https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/sales/catalog.md)
- [Overview](https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/reconciliation.md)

## API Docs

- Lucky-Tom POS API > Authentication [POS (AND, not OR)](https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/authentication/pos-and-not-or.md)
- Lucky-Tom POS API > Wallets > Top Ups [Commit top-up](https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/wallets/top-ups/commit-top-up.md)
- Lucky-Tom POS API > Wallets > Top Ups [Validate top-up](https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/wallets/top-ups/validate-top-up.md)
- Lucky-Tom POS API > Wallets > Withdrawals [Commit withdrawal](https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/wallets/withdrawals/commit-withdrawal.md)
- Lucky-Tom POS API > Wallets > Withdrawals [Reject withdrawal](https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/wallets/withdrawals/reject-withdrawal.md)
- Lucky-Tom POS API > Wallets > Withdrawals [Validate withdrawal](https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/wallets/withdrawals/validate-withdrawal.md)
- Lucky-Tom POS API > Sales > Tickets [Create ticket (Triple Tom)](https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/sales/tickets/create-ticket-triple-tom.md)
- Lucky-Tom POS API > Sales > Tickets [Get ticket by public code](https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/sales/tickets/get-ticket-by-public-code.md)
- Lucky-Tom POS API > Sales > Tickets [Create ticket (Pega Tom)](https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/sales/tickets/create-ticket-pega-tom.md)
- Lucky-Tom POS API > Sales > Tickets [Create ticket (Bingo Tom)](https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/sales/tickets/create-ticket-bingo-tom.md)
- Lucky-Tom POS API > Sales > Tickets [Get ticket by id](https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/sales/tickets/get-ticket-by-id.md)
- Lucky-Tom POS API > Sales > Payouts [Quote prize payout](https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/sales/payouts/quote-prize-payout.md)
- Lucky-Tom POS API > Sales > Payouts [Commit prize payout](https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/sales/payouts/commit-prize-payout.md)
- Lucky-Tom POS API > Sales > Catalog [List raffles](https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/sales/catalog/list-raffles.md)
- Lucky-Tom POS API > Sales > Catalog [List products](https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/sales/catalog/list-products.md)
- Lucky-Tom POS API > Sales > Catalog [List Bingo sessions](https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/sales/catalog/list-bingo-sessions.md)
- Lucky-Tom POS API > Sales > Catalog [List Pega inventories](https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/sales/catalog/list-pega-inventories.md)
- Lucky-Tom POS API > Reconciliation [List operations](https://pos-api-docs.lucky-tom.com/lucky-tom-pos-api/reconciliation/list-operations.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://pos-api-docs.lucky-tom.com/openapi.json)
- [OpenAPI YAML](https://pos-api-docs.lucky-tom.com/openapi.yaml)