Вебхуки

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

Настройка:

1. Перейдите в Панель автора → Настройки (меню с тремя точками) → раздел API-ключи

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

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

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

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

Заказ в магазине

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

Payload

application/json

namestring · enumRequiredExample: shop_orderPossible 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

statusstringOptionalExample: ok

400

Некорректные данные вебхука

401

Неверная подпись вебхука

Payload

{
  "name": "shop_order",
  "created_at": "2025-03-20T01:15:58.33246Z",
  "sent_at": "2025-03-20T01:15:58.542279448Z",
  "payload": {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "amount": 100000,
    "currency": "rub",
    "fee": 8000,
    "status": "paid",
    "email": "[email protected]",
    "isRecurrent": false,
    "period": "monthly",
    "paymentToken": "660e8400-e29b-41d4-a716-446655440001",
    "cardLast4": "4242",
    "cardBrand": "VISA",
    "starsAmount": 0,
    "onlyStars": false,
    "memberStatus": "active",
    "memberExpiresAt": "2025-12-13T15:04:05Z"
  }
}

Ошибка списания по заказу магазина

Уведомление об ошибке списания по рекуррентному заказу магазина. Отправляется после каждой неудачной попытки списания (до 3 попыток).

Payload

application/json

namestring · enumRequiredExample: shop_order_charge_failedPossible 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

statusstringOptionalExample: ok

400

Некорректные данные вебхука

401

Неверная подпись вебхука

Payload

{
  "name": "shop_order_charge_failed",
  "created_at": "2025-03-20T01:15:58.33246Z",
  "sent_at": "2025-03-20T01:15:58.542279448Z",
  "payload": {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "amount": 100000,
    "currency": "rub",
    "period": "monthly",
    "chargeRetries": 1,
    "email": "[email protected]",
    "isRecurrent": true,
    "starsAmount": 0,
    "onlyStars": false,
    "memberStatus": "active",
    "memberExpiresAt": "2025-12-13T15:04:05Z"
  }
}

Успешное списание по заказу магазина

Уведомление об успешном списании по рекуррентному заказу магазина.

Payload

application/json

namestring · enumRequiredExample: shop_order_charge_successPossible 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

statusstringOptionalExample: ok

400

Некорректные данные вебхука

401

Неверная подпись вебхука

Payload

{
  "name": "shop_order_charge_success",
  "created_at": "2025-03-20T01:15:58.33246Z",
  "sent_at": "2025-03-20T01:15:58.542279448Z",
  "payload": {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "amount": 100000,
    "currency": "rub",
    "period": "monthly",
    "email": "[email protected]",
    "isRecurrent": true,
    "starsAmount": 0,
    "onlyStars": false,
    "memberStatus": "active",
    "memberExpiresAt": "2025-12-13T15:04:05Z"
  }
}

Отмена заказа магазина

Уведомление об отмене рекуррентной подписки на заказ магазина.

Payload

application/json

namestring · enumRequiredExample: shop_order_cancelledPossible 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

statusstringOptionalExample: ok

400

Некорректные данные вебхука

401

Неверная подпись вебхука

Payload

{
  "name": "shop_order_cancelled",
  "created_at": "2025-03-20T01:15:58.33246Z",
  "sent_at": "2025-03-20T01:15:58.542279448Z",
  "payload": {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "amount": 100000,
    "currency": "rub",
    "period": "monthly",
    "cancelReason": "cancelled_by_seller",
    "email": "[email protected]",
    "isRecurrent": true,
    "starsAmount": 0,
    "onlyStars": false,
    "memberStatus": "cancelled",
    "memberExpiresAt": "2025-12-13T15:04:05Z"
  }
}

Успешное списание по токену

Уведомление об успешном списании средств по платёжному токену, инициированном мерчантом.

Payload

application/json

namestring · enumRequiredExample: shop_token_charge_successPossible 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

statusstringOptionalExample: ok

400

Некорректные данные вебхука

401

Неверная подпись вебхука

Payload

{
  "name": "shop_token_charge_success",
  "created_at": "2025-03-20T01:15:58.33246Z",
  "sent_at": "2025-03-20T01:15:58.542279448Z",
  "payload": {
    "chargeUuid": "550e8400-e29b-41d4-a716-446655440000",
    "token": "660e8400-e29b-41d4-a716-446655440001",
    "amount": 100000,
    "currency": "rub",
    "reference": "order-123",
    "processedAt": "2025-03-20T01:16:02Z"
  }
}

Ошибка списания по токену

Уведомление об ошибке списания средств по платёжному токену, инициированном мерчантом.

Payload

application/json

namestring · enumRequiredExample: shop_token_charge_failedPossible 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

statusstringOptionalExample: ok

400

Некорректные данные вебхука

401

Неверная подпись вебхука

Payload

{
  "name": "shop_token_charge_failed",
  "created_at": "2025-03-20T01:15:58.33246Z",
  "sent_at": "2025-03-20T01:15:58.542279448Z",
  "payload": {
    "chargeUuid": "550e8400-e29b-41d4-a716-446655440000",
    "token": "660e8400-e29b-41d4-a716-446655440001",
    "amount": 100000,
    "currency": "rub",
    "reference": "order-123",
    "errorCode": "payment_declined",
    "errorMessage": "Карта отклонена эмитентом"
  }
}

Возврат по заказу магазина

Уведомление о возврате средств по транзакции заказа магазина.

Payload

application/json

namestring · enumRequiredExample: shop_order_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

200

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

application/json

statusstringOptionalExample: ok

400

Некорректные данные вебхука

401

Неверная подпись вебхука

Payload

{
  "name": "shop_order_refunded",
  "created_at": "2025-03-20T01:15:58.33246Z",
  "sent_at": "2025-03-20T01:15:58.542279448Z",
  "payload": {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "transactionId": 12345,
    "amount": 100000,
    "currency": "rub",
    "status": "initiated",
    "refundedAt": "2025-03-20T01:15:58.33246Z",
    "isRecurrent": false,
    "period": "onetime",
    "starsAmount": 0,
    "onlyStars": false,
    "memberStatus": "active",
    "memberExpiresAt": "2025-12-13T15:04:05Z"
  }
}

Ошибка оплаты заказа магазина

Уведомление об ошибке первичной оплаты заказа магазина (например, карта отклонена, недостаточно средств). Отправляется для разовых платежей, которые не прошли при первой попытке оплаты.

Payload

application/json

namestring · enumRequiredExample: shop_order_payment_failedPossible 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

statusstringOptionalExample: ok

400

Некорректные данные вебхука

401

Неверная подпись вебхука

Payload

{
  "name": "shop_order_payment_failed",
  "created_at": "2025-03-20T01:15:58.33246Z",
  "sent_at": "2025-03-20T01:15:58.542279448Z",
  "payload": {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "amount": 100000,
    "currency": "rub",
    "errorCode": "payment_declined",
    "errorMessage": "Карта отклонена эмитентом",
    "email": "[email protected]",
    "starsAmount": 0,
    "onlyStars": false
  }
}