Вебхуки
Вебхуки для уведомления о событиях в системе.
Настройка:
Перейдите в Дэшборд автора → Настройки (меню три точки) → Раздел API-ключи
Сгенерируйте API-ключ, если ещё не сделали это
Укажите 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.
Уведомление о покупке подписки пользователем
new_subscriptionPossible values: Время создания события
2025-03-20T01:15:58.33246ZВремя отправки события
2025-03-20T01:15:58.542279448ZВебхук успешно обработан
okНекорректные данные вебхука
Неверная подпись вебхука
Payload
{
"name": "new_subscription",
"created_at": "2025-03-20T01:15:58.33246Z",
"sent_at": "2025-03-20T01:15:58.542279448Z",
"payload": {
"subscription_name": "Поддержите творчество 🌟",
"subscription_id": 1644,
"period_id": 1547,
"period": "monthly",
"price": 1000,
"amount": 700,
"currency": "eur",
"trb_user_id": "T-31326",
"telegram_user_id": 12321321,
"telegram_username": "durov",
"channel_id": 614,
"channel_name": "lbs",
"expires_at": "2025-04-20T01:15:57.305733Z",
"type": "regular"
}
}Уведомление об отмене подписки пользователем
cancelled_subscriptionPossible values: Время создания события
2025-03-21T11:20:44.013969ZВремя отправки события
2025-03-21T11:20:44.527657077ZВебхук успешно обработан
okНекорректные данные вебхука
Неверная подпись вебхука
Payload
{
"name": "cancelled_subscription",
"created_at": "2025-03-21T11:20:44.013969Z",
"sent_at": "2025-03-21T11:20:44.527657077Z",
"payload": {
"subscription_name": "Присоединяйтесь к закрытому клубу 🎉",
"subscription_id": 1646,
"period_id": 1549,
"period": "monthly",
"price": 1000,
"amount": 1000,
"currency": "eur",
"trb_user_id": "T-31326",
"telegram_user_id": 12321321,
"telegram_username": "durov",
"channel_id": 614,
"channel_name": "lbs",
"cancel_reason": "",
"expires_at": "2025-03-20T11:13:44.737Z",
"type": "regular"
}
}Уведомление о продлении подписки
Время создания события
2025-03-21T11:20:44.013969Zrenewed_subscriptionPossible values: Время отправки события
2025-03-21T11:20:44.527657077ZВебхук успешно обработан
okНекорректные данные вебхука
Неверная подпись вебхука
Payload
{
"created_at": "2025-03-21T11:20:44.013969Z",
"name": "renewed_subscription",
"payload": {
"subscription_name": "Поддержите творчество 🌟",
"subscription_id": 1644,
"period_id": 1547,
"period": "monthly",
"price": 1000,
"amount": 700,
"currency": "eur",
"trb_user_id": "T-31326",
"telegram_user_id": 12321321,
"telegram_username": "durov",
"email": "user@example.com",
"web_app_link": "https://t.me/metal3devbot/app?startapp=syX",
"channel_id": 614,
"channel_name": "lbs",
"expires_at": "2025-04-20T01:15:57.305733Z",
"type": "regular"
},
"sent_at": "2025-03-21T11:20:44.527657077Z"
}Уведомление о создании нового физического заказа
physical_order_createdPossible values: Время создания события
Время отправки события
Вебхук успешно обработан
No content
Некорректные данные вебхука
Неверная подпись вебхука
Payload
{
"name": "physical_order_created",
"created_at": "2026-01-01T00:00:00.000Z",
"sent_at": "2026-01-01T00:00:00.000Z",
"payload": {
"order_id": 12345,
"status": "pending",
"trb_user_id": "T-31326",
"telegram_user_id": 12321321,
"telegram_username": "durov",
"products": [
{
"product_name": "Футболка с принтом",
"quantity": 2,
"price": 150000,
"currency": "rub"
}
],
"total": 300000,
"currency": "rub",
"shipping_address": "Россия, Москва, ул. Пушкина, д. 10, кв. 5",
"tracking_number": "RU123456789CN",
"created_at": "2025-03-20T01:15:58.33246Z",
"updated_at": "2025-03-20T01:15:58.33246Z"
}
}Уведомление об отправке физического заказа
physical_order_shippedPossible values: Время создания события
Время отправки события
Вебхук успешно обработан
No content
Некорректные данные вебхука
Неверная подпись вебхука
Payload
{
"name": "physical_order_shipped",
"created_at": "2026-01-01T00:00:00.000Z",
"sent_at": "2026-01-01T00:00:00.000Z",
"payload": {
"order_id": 12345,
"status": "pending",
"trb_user_id": "T-31326",
"telegram_user_id": 12321321,
"telegram_username": "durov",
"products": [
{
"product_name": "Футболка с принтом",
"quantity": 2,
"price": 150000,
"currency": "rub"
}
],
"total": 300000,
"currency": "rub",
"shipping_address": "Россия, Москва, ул. Пушкина, д. 10, кв. 5",
"tracking_number": "RU123456789CN",
"created_at": "2025-03-20T01:15:58.33246Z",
"updated_at": "2025-03-20T01:15:58.33246Z"
}
}Уведомление об отмене физического заказа
physical_order_canceledPossible values: Время создания события
Время отправки события
Вебхук успешно обработан
No content
Некорректные данные вебхука
Неверная подпись вебхука
Payload
{
"name": "physical_order_canceled",
"created_at": "2026-01-01T00:00:00.000Z",
"sent_at": "2026-01-01T00:00:00.000Z",
"payload": {
"order_id": 12345,
"status": "pending",
"trb_user_id": "T-31326",
"telegram_user_id": 12321321,
"telegram_username": "durov",
"products": [
{
"product_name": "Футболка с принтом",
"quantity": 2,
"price": 150000,
"currency": "rub"
}
],
"total": 300000,
"currency": "rub",
"shipping_address": "Россия, Москва, ул. Пушкина, д. 10, кв. 5",
"tracking_number": "RU123456789CN",
"created_at": "2025-03-20T01:15:58.33246Z",
"updated_at": "2025-03-20T01:15:58.33246Z"
}
}Уведомление о новом донате
new_donationPossible values: Время создания события
2025-03-20T01:15:58.33246ZВремя отправки события
2025-03-20T01:15:58.542279448ZВебхук успешно обработан
okНекорректные данные вебхука
Неверная подпись вебхука
Payload
{
"name": "new_donation",
"created_at": "2025-03-20T01:15:58.33246Z",
"sent_at": "2025-03-20T01:15:58.542279448Z",
"payload": {
"donation_request_id": 123,
"donation_name": "Поддержать мою работу",
"message": "Спасибо за ваш контент!",
"period": "once",
"amount": 1000,
"currency": "usd",
"anonymously": false,
"web_app_link": "https://t.me/tribute/app?startapp=d123",
"email": "donor@example.com",
"trb_user_id": "W-15408",
"telegram_user_id": 12321321,
"telegram_username": "durov"
}
}Уведомление о платеже по регулярному донату
recurrent_donationPossible values: Время создания события
2025-03-20T01:15:58.33246ZВремя отправки события
2025-03-20T01:15:58.542279448ZВебхук успешно обработан
okНекорректные данные вебхука
Неверная подпись вебхука
Payload
{
"name": "recurrent_donation",
"created_at": "2025-03-20T01:15:58.33246Z",
"sent_at": "2025-03-20T01:15:58.542279448Z",
"payload": {
"donation_request_id": 123,
"donation_name": "Ежемесячная поддержка",
"period": "monthly",
"amount": 500,
"currency": "eur",
"anonymously": false,
"web_app_link": "https://t.me/tribute/app?startapp=d456",
"trb_user_id": "W-15408",
"telegram_user_id": 12321321,
"telegram_username": "durov"
}
}Уведомление об отмене регулярного доната
cancelled_donationPossible values: Время создания события
2025-03-20T01:15:58.33246ZВремя отправки события
2025-03-20T01:15:58.542279448ZВебхук успешно обработан
okНекорректные данные вебхука
Неверная подпись вебхука
Payload
{
"name": "cancelled_donation",
"created_at": "2025-03-20T01:15:58.33246Z",
"sent_at": "2025-03-20T01:15:58.542279448Z",
"payload": {
"donation_request_id": 123,
"donation_name": "Ежемесячная поддержка",
"period": "monthly",
"amount": 500,
"currency": "eur",
"anonymously": false,
"web_app_link": "https://t.me/tribute/app?startapp=d456",
"trb_user_id": "W-15408",
"telegram_user_id": 12321321,
"telegram_username": "durov"
}
}Уведомление о покупке цифрового товара
new_digital_productPossible values: Время создания события
2025-03-20T01:15:58.33246ZВремя отправки события
2025-03-20T01:15:58.542279448ZВебхук успешно обработан
okНекорректные данные вебхука
Неверная подпись вебхука
Payload
{
"name": "new_digital_product",
"created_at": "2025-03-20T01:15:58.33246Z",
"sent_at": "2025-03-20T01:15:58.542279448Z",
"payload": {
"product_id": 456,
"product_name": "VPN Доступ - 1 месяц",
"amount": 500,
"currency": "usd",
"trb_user_id": "T-31326",
"telegram_user_id": 12321321,
"telegram_username": "durov",
"purchase_id": 78901,
"transaction_id": 234567,
"purchase_created_at": "2025-03-20T01:15:58.33246Z"
}
}Уведомление о возврате цифрового товара. Этот вебхук срабатывает когда:
- Пользователь возвращает Stars через App Store, Google Play или банк
- Автор инициирует возврат через API
Важно: Используйте purchase_id для сопоставления возвратов с оригинальными покупками и отзыва доступа к цифровому контенту.
digital_product_refundedPossible values: Время создания события
2025-03-20T01:15:58.33246ZВремя отправки события
2025-03-20T01:15:58.542279448ZВебхук успешно обработан
okНекорректные данные вебхука
Неверная подпись вебхука
Payload
{
"name": "digital_product_refunded",
"created_at": "2025-03-20T01:15:58.33246Z",
"sent_at": "2025-03-20T01:15:58.542279448Z",
"payload": {
"product_id": 456,
"product_name": "VPN Доступ - 1 месяц",
"amount": 500,
"currency": "usd",
"trb_user_id": "T-31326",
"telegram_user_id": 12321321,
"telegram_username": "durov",
"purchase_id": 78901,
"transaction_id": 234567,
"refund_reason": "telegram_refund",
"refunded_at": "2025-03-20T02:30:00.33246Z"
}
}Last updated