Перейти к содержимому
Разделы

Руководства

Гостевые предзаказы

Создайте гостевую корзину, принятие расчёта и управление предзаказом.

Настройте доступ

В настройках обслуживания заведения настройте публичный канал: опубликованный канал продаж, активного служебного пользователя, public handle и разрешённые origin. Настройте проверку контакта и политики исполнения. Этот flow использует гостевые токены черновика и управления, а не ключ партнёра.

Маршрут кабинета: /venues/:venueId/settings/fulfillment → Ресурсы → Публичный канал. Настройка публичного канала требует preorders.external.manage; правила исполнения — preorders.policies.manage.

Первый успешный сценарий

Выполните шаги по порядку. Откройте каждый метод для точного тела, обязательных заголовков и схемы ответа.

  1. Прочитайте публичный каталог; соберите корзину из разрешённых позиций с идентификатором меню.
  2. Создайте черновик с Idempotency-Key. Сохраните draftReference и Bearer-токен черновика.
  3. Подтвердите контакт кодом, получите актуальный одноразовый расчёт и примите его до истечения срока.
  4. Обменяйте выданный одноразовый grant на Bearer-токен управления. Прочитайте предзаказ и допустимые действия.
  5. Для разрешённого изменения получите расчёт поправки и примите его с ожидаемой ревизией; отменяйте заказ только в пределах гостевой политики.

Состояния, повторы и восстановление

Создание черновика не создаёт заказ. Изменение защищённых контактных данных запускает повторную проверку. Разделяйте токены черновика и управления. Использованный или истёкший grant не создаёт новую сессию; используйте восстановление доступа соответствующего гостевого flow.

Hallify использует обязательные cookies и опциональную аналитику.

Обязательные cookies поддерживают вход, язык и тему. Аналитика выключена, пока вы явно ее не разрешите.