> For the complete documentation index, see [llms.txt](https://wiki.tribute.tg/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.tribute.tg/ru/for-shops/api-magazina/vebkhuki.md).

# Вебхуки

Вебхуки для уведомлений о событиях.

**Настройка:**

1. Перейдите в Панель автора → Настройки (меню с тремя точками) → раздел API-ключи
2. Сгенерируйте API-ключ, если ещё не сделали
3. Укажите URL вашего вебхука в настройках

**Проверка подписи:** Каждый запрос содержит заголовок `trbt-signature` с HMAC-SHA256 подписью тела запроса, подписанной вашим API-ключом.

**Повторные попытки:** При ошибке доставки система повторяет отправку с экспоненциальной задержкой в течение \~24 часов: 5мин, 15мин, 30мин, 1ч, 2ч, 4ч, 8ч, 8ч.

{% openapi-webhook spec="shop-ru" name="shopOrder" method="post" %}
[shop-ru](https://tribute.tg/api/v1/openapi/shop/ru)
{% endopenapi-webhook %}

{% openapi-webhook spec="shop-ru" name="shopOrderChargeFailed" method="post" %}
[shop-ru](https://tribute.tg/api/v1/openapi/shop/ru)
{% endopenapi-webhook %}

{% openapi-webhook spec="shop-ru" name="shopOrderChargeSuccess" method="post" %}
[shop-ru](https://tribute.tg/api/v1/openapi/shop/ru)
{% endopenapi-webhook %}

{% openapi-webhook spec="shop-ru" name="shopOrderCancelled" method="post" %}
[shop-ru](https://tribute.tg/api/v1/openapi/shop/ru)
{% endopenapi-webhook %}

{% openapi-webhook spec="shop-ru" name="shopOrderRefunded" method="post" %}
[shop-ru](https://tribute.tg/api/v1/openapi/shop/ru)
{% endopenapi-webhook %}

{% openapi-webhook spec="shop-ru" name="shopOrderPaymentFailed" method="post" %}
[shop-ru](https://tribute.tg/api/v1/openapi/shop/ru)
{% endopenapi-webhook %}

{% openapi-webhook spec="shop-ru" name="shopOrderPaymentReceived" method="post" %}
[shop-ru](https://tribute.tg/api/v1/openapi/shop/ru)
{% endopenapi-webhook %}