Глоссарий FazerCards
Webhook
HTTP POST, который платформа отправляет на ваш URL по событию (заказ выполнен / отказан / возврат), чтобы не нужно было опрашивать API.
Webhook — это исходящий HTTP POST от FazerCards на URL, указанный в кабинете. Тело — JSON с типом события (order.completed / order.failed / order.refunded), id заказа и подписанным заголовком для проверки подлинности. Webhooks заменяют polling: интеграция реагирует мгновенно — именно так Telegram-боты и витрины обеспечивают мгновенную доставку.
Главные факты
- Стандартные события: order.completed, order.failed, order.refunded.
- Подписанный заголовок защищает от подделки — проверяйте до обработки.
- Отвечайте 2xx в течение нескольких секунд; долгую работу выносите в очередь.
- Неудачные доставки ретраются с экспоненциальной задержкой.