Pay-at-Table API
A unified Pay-at-Table API across every connected POS. Integrate once with Mozrest and reach every venue, regardless of the underlying POS vendor.
Overview
The API covers two flows:
- Bill retrieval - fetch the live bill for a table.
- Payment notification - tell Mozrest a guest paid (full or partial). For full payments, Mozrest closes the order on the POS.
The endpoints are available on every venue connected to a Pay-at-Table-enabled POS. The set of POS systems that support live bill retrieval and payment forwarding grows incrementally - the canonical signal is the /features endpoint per venue. The Mozrest POS simulator is the first POS with both capabilities live; concrete adapters for real POS systems land per-vendor in subsequent phases.
Get started
Everything a partner needs to integrate, in order.
Getting started Step 1
Environments, authentication, identifiers, and idempotency. Read this before calling any endpoint.
List venues Step 2
Discover the venues your token is scoped to. The IDs returned here drive every other endpoint.
List tables Step 3
Fetch the venue's tables once at onboarding. Encode the returned IDs in your QR codes.
Get the bill Step 4
Retrieve the live open order for a table - checks, items, totals.
Submit payment Step 5
Notify Mozrest a guest paid. Full payments close the order; partials accumulate.
Payment status Step 6
Poll a payment to a terminal state after a 202. Guaranteed terminal within 120 seconds.
Reference
Discovery, error handling, and the sandbox environment.
Feature discovery
Per-venue capability flags so your UI knows what's available before relying on a feature.
Errors
Common envelope and the full status code table for every endpoint.