Портал партнёра

Как уведомить внешнюю систему в тот же момент, когда здесь что-то происходит. Вы подписываете адрес на событие, и платформа начинает его вызывать — с журналом каждой доставки.

Тенант регистрирует ENDPOINT (ваш URL), чтобы получать УВЕДОМЛЕНИЯ по HTTP каждый раз, когда в Tenka происходит бизнес-событие, — договор подписан, документ оплачен, FCA открыт. Каждое уведомление — это POST, подписанный HMAC-SHA256 от тела с использованием СЕКРЕТА, который знаете только вы и Tenka (header X-Tenka-Signature): ваша система проверяет подпись и знает, что вызов пришёл от Tenka и не был подделан. Здесь вы создаёте подписку (url + событие + секрет), включаете/отключаете её, следите за ЖУРНАЛОМ доставок (PENDING → DELIVERED | FAILED, с числом попыток и backoff) и можете отправить ТЕСТОВОЕ событие или повторно поставить в очередь неудачную доставку. Событие «*» подписывает на все. Не путать с внутренними вебхуками биллинга (Asaas).

Каждая доставка подписывается секретом подписки. Получатель ОБЯЗАН проверить эту подпись, прежде чем доверять содержимому, — иначе любой, кто узнает ваш URL, сможет отправить на него поддельное событие.

Кнопка теста отправляет реальное событие на ваш endpoint прямо сейчас, не дожидаясь самого факта. Это самый быстрый способ обнаружить ошибку в URL, файрволе или подписи — до того, как первое настоящее событие потеряется в очереди.

A API pública /api/v1 é congelada: nada some nem muda de tipo; mudança que quebra vai para /v2. O SDK sai do próprio contrato: /api/v1/sdk/tenka.js e /api/v1/sdk/tenka.py. O histórico de versões está no documento API-CHANGELOG da Biblioteca.

Недоступный endpoint не теряет событие: платформа повторяет попытки с нарастающими интервалами. Журнал показывает статус и число попыток — именно там выясняется, что интеграция «встала», потому что на другой стороне истёк сертификат.

O log de eventos mostra tudo que a conta enviou, em todas as inscrições, com filtro por evento e situação. Reenviar cria uma entrega nova com o mesmo conteúdo e o cabeçalho X-Tenka-Replay-Of com o id da original, para o sistema que recebe não duplicar. Toda entrega leva X-Tenka-Event-Version com a versão do contrato.

Какие мои системы Tenka уведомляет, когда что-то происходит, и доходят ли доставки? Зарегистрируйте endpoint (ваш URL) для бизнес-события, и Tenka отправит POST, подписанный HMAC-SHA256 от тела (header X-Tenka-Signature); ваша система проверяет подпись и убеждается, что вызов пришёл отсюда и не был подделан. Журнал доставок показывает PENDING, DELIVERED или FAILED с числом попыток и backoff; можно отправить тестовое событие и повторно поставить в очередь неудачную доставку. Событие * подписывает endpoint на все события.