Содержание статьи
11.1 Настройка вебхуков
Нотификации (webhooks) — это POST-запросы, которые Lamoda отправляет на ваш URL при изменении статуса заказа, товара или FBO-поставки.
Чек-лист подключения
| № | Действие | Кто делает |
| 1 | Реализовать endpoint для приёма POST-запросов | Вы |
| 2 | Предоставить URL для получения нотификаций (валидный HTTPS URL, макс. 1024 символа) | Вы → KAM |
| 3 | Добавить IP Lamoda в whitelist (получить у KAM) | Вы |
| 4 | Предоставить логин и пароль для Basic Auth (опционально) | Вы → KAM |
| 5 | Настроить подписку на нужные события | KAM (или вы через API) |
Требования к endpoint
URL
Ваш endpoint должен:
- Принимать POST-запросы
- Быть доступен 24/7
- Работать по HTTPS (URL проходит валидацию
@Assert\Url) - Отвечать быстро (рекомендуется < 5 сек)
Аутентификация
Lamoda поддерживает два режима аутентификации при отправке вебхуков:
| Тип | Описание |
none
|
Без аутентификации (по умолчанию). Рекомендуем ограничить доступ по IP. |
basic
|
HTTP Basic Auth. Lamoda передаёт заголовок Authorization: Basic <base64(username:password)> при каждом запросе. Укажите логин и пароль при настройке подписки.
|
Если при создании или редактировании подписки указаны username и password — аутентификация автоматически переключается на basic. Иначе используется none.
Коды ответа
| Код | Поведение Lamoda |
2xx
|
✅ Нотификация успешно доставлена. Сообщению присваивается статус sent.
|
4xx
|
❌ Ошибка клиента. Сообщению присваивается статус failed с описанием ошибки http request failed. Проверьте URL, аутентификацию и формат ответа.
|
5xx
|
Помогла эта информация?Спасибо за отзыв 
|