Guest preorders

Configure access

In venue fulfillment settings, configure the Public channel with a published sales channel, active service actor, public handle and allowed origins. Configure contact verification and the required fulfillment policies. This flow uses guest draft and manage capabilities, not a partner key.

Cabinet route: /venues/:venueId/settings/fulfillment → Resources → Public channel. Public-channel configuration requires preorders.external.manage; fulfillment policies require preorders.policies.manage.

• Open Hallify

First successful workflow

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

1. Read the public catalog; compose a cart from its eligible items and menu identity.
2. Create a draft with Idempotency-Key. Retain draftReference and the draft Bearer token.
3. Verify the contact code to receive the current single-use quote; accept that quote before expiry.
4. Exchange the returned one-time manage grant for a manage Bearer token. Read the preorder and its allowed actions.
5. For a permitted change, quote the amendment and accept it at the expected revision; cancel only within the guest cancellation policy.

• Get the publicly eligible preorder catalog
• Create an encrypted public preorder draft
• Verify contact and issue a commercial quote
• Accept a single-use public preorder quote
• Exchange a URL-safe grant for a manage session
• View the guest-owned preorder projection

State, retries and recovery

Draft creation does not create an order. Editing protected contact details restarts verification. Keep the draft token and manage token separate. A consumed or expired grant cannot bootstrap another session; use the owning guest access recovery process.

• Errors and limits
• Access and authentication