> 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/api-dokumentaciya/vebkhuki.md).

# Вебхуки

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

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

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

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

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

**Тип подписки (payload.type) в событиях подписок:**

* `regular` — обычная платная подписка (оформление обычной подписки или продление)
* `gift` — подарочная подписка (покупка подарка)
* `trial` — пробная подписка (активация)

**Переходы типов:** При продлении `gift` или `trial` следующая подписка становится `regular` и это отражается в событии `renewed_subscription`.

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

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

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

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

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

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

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

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

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

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

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