Webhooks

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

Настройка:

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

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

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

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

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

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

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

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
200
Вебхук успешно обработан
application/json

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",
    "user_id": 31326,
    "telegram_user_id": 12321321,
    "channel_id": 614,
    "channel_name": "lbs",
    "expires_at": "2025-04-20T01:15:57.305733Z"
  }
}

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

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

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
200
Вебхук успешно обработан
application/json

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",
    "user_id": 31326,
    "telegram_user_id": 12321321,
    "channel_id": 614,
    "channel_name": "lbs",
    "cancel_reason": "",
    "expires_at": "2025-03-20T11:13:44.737Z"
  }
}

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

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

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

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

sent_atstring · date-timeRequired

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

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

Payload

{
  "name": "physical_order_created",
  "created_at": "2025-06-24T16:44:27.196Z",
  "sent_at": "2025-06-24T16:44:27.196Z",
  "payload": {
    "order_id": 12345,
    "status": "pending",
    "user_id": 31326,
    "telegram_user_id": 12321321,
    "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"
  }
}

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

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

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

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

sent_atstring · date-timeRequired

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

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

Payload

{
  "name": "physical_order_shipped",
  "created_at": "2025-06-24T16:44:27.196Z",
  "sent_at": "2025-06-24T16:44:27.196Z",
  "payload": {
    "order_id": 12345,
    "status": "pending",
    "user_id": 31326,
    "telegram_user_id": 12321321,
    "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"
  }
}

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

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

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

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

sent_atstring · date-timeRequired

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

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

Payload

{
  "name": "physical_order_canceled",
  "created_at": "2025-06-24T16:44:27.196Z",
  "sent_at": "2025-06-24T16:44:27.196Z",
  "payload": {
    "order_id": 12345,
    "status": "pending",
    "user_id": 31326,
    "telegram_user_id": 12321321,
    "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"
  }
}
PreviousOrdersNextКак оплатить подписку