Вебхуки

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

Настройка:

  1. Перейдите в Дэшборд автора → Настройки (меню три точки) → Раздел API-ключи

  2. Сгенерируйте API-ключ, если ещё не сделали это

  3. Укажите URL вашего вебхука в настройках вебхуков

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

Повторные попытки: При ошибке доставки система повторяет попытки через 5мин, 15мин, 30мин, 1ч, 10ч.

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

  • regular — обычная платная подписка (оформление обычной подписки или продление)

  • gift — подарочная подписка (покупка подарка)

  • trial — пробная подписка (активация)

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

Новая подписка

Уведомление о покупке подписки пользователем

Payload
namestring · enumRequiredExample: new_subscriptionPossible values:
created_atstring · date-timeRequired

Время создания события

Example: 2025-03-20T01:15:58.33246Z
sent_atstring · date-timeRequired

Время отправки события

Example: 2025-03-20T01:15:58.542279448Z
Responses
chevron-right
200

Вебхук успешно обработан

application/json

Payload

Отмена подписки

Уведомление об отмене подписки пользователем

Payload
namestring · enumRequiredExample: cancelled_subscriptionPossible values:
created_atstring · date-timeRequired

Время создания события

Example: 2025-03-21T11:20:44.013969Z
sent_atstring · date-timeRequired

Время отправки события

Example: 2025-03-21T11:20:44.527657077Z
Responses
chevron-right
200

Вебхук успешно обработан

application/json

Payload

Продление подписки

Уведомление о продлении подписки

Payload
created_atstring · date-timeRequired

Время создания события

Example: 2025-03-21T11:20:44.013969Z
namestring · enumRequiredExample: renewed_subscriptionPossible values:
sent_atstring · date-timeRequired

Время отправки события

Example: 2025-03-21T11:20:44.527657077Z
Responses
chevron-right
200

Вебхук успешно обработан

application/json

Payload

Создан физический заказ

Уведомление о создании нового физического заказа

Payload
namestring · enumRequiredExample: physical_order_createdPossible values:
created_atstring · date-timeRequired

Время создания события

sent_atstring · date-timeRequired

Время отправки события

Responses
chevron-right
200

Вебхук успешно обработан

No content

Payload

Физический заказ отправлен

Уведомление об отправке физического заказа

Payload
namestring · enumRequiredExample: physical_order_shippedPossible values:
created_atstring · date-timeRequired

Время создания события

sent_atstring · date-timeRequired

Время отправки события

Responses
chevron-right
200

Вебхук успешно обработан

No content

Payload

Физический заказ отменен

Уведомление об отмене физического заказа

Payload
namestring · enumRequiredExample: physical_order_canceledPossible values:
created_atstring · date-timeRequired

Время создания события

sent_atstring · date-timeRequired

Время отправки события

Responses
chevron-right
200

Вебхук успешно обработан

No content

Payload

Новый донат

Уведомление о новом донате

Payload
namestring · enumRequiredExample: new_donationPossible values:
created_atstring · date-timeRequired

Время создания события

Example: 2025-03-20T01:15:58.33246Z
sent_atstring · date-timeRequired

Время отправки события

Example: 2025-03-20T01:15:58.542279448Z
Responses
chevron-right
200

Вебхук успешно обработан

application/json

Payload

Регулярный донат

Уведомление о платеже по регулярному донату

Payload
namestring · enumRequiredExample: recurrent_donationPossible values:
created_atstring · date-timeRequired

Время создания события

Example: 2025-03-20T01:15:58.33246Z
sent_atstring · date-timeRequired

Время отправки события

Example: 2025-03-20T01:15:58.542279448Z
Responses
chevron-right
200

Вебхук успешно обработан

application/json

Payload

Отмена доната

Уведомление об отмене регулярного доната

Payload
namestring · enumRequiredExample: cancelled_donationPossible values:
created_atstring · date-timeRequired

Время создания события

Example: 2025-03-20T01:15:58.33246Z
sent_atstring · date-timeRequired

Время отправки события

Example: 2025-03-20T01:15:58.542279448Z
Responses
chevron-right
200

Вебхук успешно обработан

application/json

Payload

Покупка цифрового товара

Уведомление о покупке цифрового товара

Payload
namestring · enumRequiredExample: new_digital_productPossible values:
created_atstring · date-timeRequired

Время создания события

Example: 2025-03-20T01:15:58.33246Z
sent_atstring · date-timeRequired

Время отправки события

Example: 2025-03-20T01:15:58.542279448Z
Responses
chevron-right
200

Вебхук успешно обработан

application/json

Payload

Цифровой товар возвращён

Уведомление о возврате цифрового товара. Этот вебхук срабатывает когда:

  • Пользователь возвращает Stars через App Store, Google Play или банк
  • Автор инициирует возврат через API

Важно: Используйте purchase_id для сопоставления возвратов с оригинальными покупками и отзыва доступа к цифровому контенту.

Payload
namestring · enumRequiredExample: digital_product_refundedPossible values:
created_atstring · date-timeRequired

Время создания события

Example: 2025-03-20T01:15:58.33246Z
sent_atstring · date-timeRequired

Время отправки события

Example: 2025-03-20T01:15:58.542279448Z
Responses
chevron-right
200

Вебхук успешно обработан

application/json

Payload

Last updated