External orders & POS

Configure access

The venue workspace is /venues/:venueId/pos. Source provisioning requires pos.externalOrders.manage. The current cabinet exposes the external-order inbox, but no source-creation form is present. Ask the Hallify administrator to provision the source through the existing administrative setup, then provide sourceId and the one-time signing secret securely. Product identities and menu versions must match the venue’s published channel.

• Open Hallify

First successful workflow

Follow these steps in order. Open each method for its exact body, required headers and response schema.

1. POST the external order identifier, increasing revision, service mode and items to the source orders endpoint. Sign the body using the external-orders profile.
2. Keep the returned native order identity and replay result. Reuse the same revision only for an identical retry.
3. For cancellation, POST the next external revision and reason to the order cancellation endpoint.

• Ingest a signed external order revision
• Ingest a signed external-order cancellation revision

State, retries and recovery

A conflicting revision or changed replay payload is rejected. An OPEN native order may be canceled atomically; a SUBMITTED order remains for explicit operator resolution. Do not treat cancellation acceptance as unconditional cancellation of an already submitted order.

• Errors and limits
• Access and authentication