Исходящие вебхуки

Назначение

Ваш сервер получает HTTP POST от BillBill при изменениях в подписках, счетах, платежах, пользователях и метриках. Так вы синхронизируете состояние с CRM, биллингом внутри продукта и доступом к фичам.

Настройка

1. Реализуйте HTTPS endpoint (200 OK после приёма).
2. В админке или через API создайте webhook endpoint (webhookNewEndpoint в MerchantApi).
3. Укажите список типов событий (строки через разделитель в модели мерчанта — см. API).
4. Сохраните секрет для проверки подписи, если он выдаётся BillBill (уточните в актуальной документации API / примере payload).

Каталог событий

Полный перечень констант в коде API — в ListeningEventList; человекочитаемый список — на странице События вебхуков.

Рекомендации по обработке

• Отвечайте быстро (десятки–сотни мс); тяжёлую работу выносите в очередь.
• Учитывайте повторные доставки: храните eventId / пару (тип, идентификатор сущности, время) для идемпотентности.
• Логируйте сырое тело для отладки (без персональных данных в открытом виде в незащищённых логах).

Тестирование

В админке доступны логи доставки вебхуков; через API — повторная отправка (webhookResend).