50% OFF with code BLACKFRIDAY5020% OFF with code BLACKFRIDAY20
Интеграции и APIВсе тарифы

Вебхуки для новых заказов

Вебхук отправляет каждый новый заказ и каждое его изменение в вашу систему как подписанное JSON-сообщение. Вы даёте Menuthere HTTPS-адрес и секрет, а затем проверяете подпись каждого запроса. Кнопка проверки и журнал доставок позволяют убедиться, что всё работает.

Где
Set up by Menuthere support
Тариф
Панель не ограничивает вебхуки по тарифу.
Время
15 мин
Обновлено

Настройте вебхук

Шаг 1: Отправьте поддержке свой адрес

Вебхуков в панели пока нет, поэтому их настраивает поддержка Menuthere. Отправьте поддержке адрес, который будет получать заказы. Он должен начинаться с https:// и быть доступен из интернета. Адреса вроде localhost или из частной сети вызвать нельзя.

Шаг 2: Сохраните секрет подписи

Поддержка включает вебхуки заказов и даёт вам секрет подписи. Храните его только на своём сервере. С его помощью вы проверяете, что каждый запрос действительно пришёл от Menuthere.

Шаг 3: Попросите тестовое событие

Попросите поддержку отправить тестовое событие. Оно отправляет пример order.created на ваш адрес, а результат показывает Delivered с кодом ответа вашего адреса или то, что пошло не так.

Что отправляет Menuthere

СобытиеКогда отправляется
order.createdЗаказ оформлен.
order.status_updatedМеняется статус заказа, например принят, еда готова или выполнен.
payment.status_updatedЗаказ отмечен оплаченным или меняется способ оплаты.
delivery.status_updatedНазначен курьер или меняется состояние доставки.
ЗаголовокЗначение
x-menuthere-eventНазвание события.
x-menuthere-timestampUnix-время в секундах, при каждой попытке ставится заново.
x-menuthere-signatureШестнадцатеричный HMAC-SHA256 исходного тела запроса, посчитанный с вашим секретом.

Тело — это конверт с event, уникальным id, created_at и data. Тестовое событие также несёт "test": true, так что не передавайте его на кухню. Для order.created в data лежат поля ниже.

ПолеСодержимое
order_id, order_numberID заказа и номер, который видит ваша команда.
status, type, placed_at, currencyТекущий статус, тип заказа, время оформления и валюта.
totalssubtotal, delivery_charge, packing_charge, gst, discount, grand_total.
customername, phone, address.
tablenumber и name стола для заказа за столом, иначе пусто.
itemsКаждая строка: name, quantity, unit_price, total_price, variant, notes.
notes, paymentПримечание клиента, а также method оплаты и is_paid — оплачен ли заказ.

Проверка и надёжность

  • Сверяйте подпись с исходным телом запроса. Если разобрать и заново закодировать JSON, изменятся пробелы и порядок, и подпись не совпадёт.
  • Будьте идемпотентны. Один и тот же id может прийти дважды. Используйте его, чтобы не создать второй кухонный тикет.
  • Отвечайте 2xx быстро. Menuthere ждёт 8 секунд на попытку и пробует до трёх раз: через 1,5 секунды, а затем через 5. Таймаут, 5xx, 408 и 429 повторяются. Любой другой 4xx понимается как осознанный отказ, и повторы прекращаются.
  • Смотрите Recent deliveries. Панель показывает попытки за последние 24 часа, самые новые первыми, с кодом ответа и временем. Каждый повтор — отдельная строка.
Что стоит знатьСбой вашего адреса никогда не останавливает и не задерживает заказ клиента.

Вопросы

Можно ли направить вебхук на сервер в моей собственной сети?
Напрямую нет. Адрес должен быть публичным HTTPS. Localhost и адреса частной сети отклоняются.
Можно ли сообщить кассе, что заказ принят?
Хранится ли журнал доставок вечно?
Панель показывает попытки за последние 24 часа.

Не нашли ответ? Напишите на help@mail.menuthere.com или в чат, с 9:00 до 21:00.Справочный центрЦеныmenuthere.com