> For the complete documentation index, see [llms.txt](https://wiki.tribute.top/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.tribute.top/br-pt/para-lojas/api/webhooks.md).

# Webhooks

Webhook notifications for shop events.

**Setup:**

1. Go to Creator Dashboard → Settings (three-dot menu) → API Keys section
2. Generate API key if you haven't already
3. Specify your webhook URL in the webhook settings

**Signature verification:** Each request contains `trbt-signature` header with HMAC-SHA256 signature of request body signed with your API key.

**Retry attempts:** On delivery failure, system retries with exponential backoff over \~24 hours: 5min, 15min, 30min, 1h, 2h, 4h, 8h, 8h.

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

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

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

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

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

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

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