Portail du partenaire

Comment prévenir un système externe à l'instant où quelque chose se produit ici. Vous inscrivez une adresse à un événement, et la plateforme se met à l'appeler — avec une trace de chaque livraison.

Le tenant enregistre un ENDPOINT (une URL à vous) pour être PRÉVENU par HTTP chaque fois qu'un événement métier se produit dans Tenka — contrat signé, titre payé, FCA ouvert. Chaque notification est un POST signé en HMAC-SHA256 du corps avec un SECRET que seuls vous et Tenka connaissez (header X-Tenka-Signature) : votre système vérifie la signature et sait que l'appel vient de Tenka et n'a pas été altéré. Ici, vous créez l'inscription (url + événement + secret), l'activez/désactivez, suivez la TRACE des livraisons (EN ATTENTE → LIVRÉ | ÉCHEC, avec le nombre de tentatives et le backoff), et pouvez déclencher un événement de TEST ou remettre en file une livraison qui a échoué. L'événement « * » inscrit à tous. Distinct des webhooks internes de facturation (Asaas).

Chaque livraison est signée avec le secret de l'inscription. Le destinataire DOIT vérifier cette signature avant de se fier au contenu — sans cela, quiconque découvre votre URL peut y envoyer un faux événement.

Le bouton de test envoie dès maintenant un événement réel à votre endpoint, sans attendre que le fait se produise. C'est le moyen le plus rapide de découvrir une erreur d'URL, de pare-feu ou de signature — avant que le premier vrai événement ne se perde dans la file.

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.

Un endpoint hors service ne perd pas l'événement : la plateforme réessaie en espaçant les tentatives. La trace montre le statut et le nombre de tentatives — c'est là qu'on découvre que l'intégration « s'est arrêtée » parce que le certificat de l'autre côté a expiré.

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.

Quels systèmes à moi Tenka prévient-il quand quelque chose se produit — et les livraisons arrivent-elles ? Enregistrez un endpoint (une URL à vous) par événement métier et Tenka envoie un POST signé en HMAC-SHA256 du corps (header X-Tenka-Signature), que votre système vérifie pour savoir que l'appel vient d'ici et n'a pas été altéré. La trace des livraisons indique EN ATTENTE, LIVRÉ ou ÉCHEC, avec le nombre de tentatives et le backoff ; vous pouvez déclencher un événement de test et remettre en file une livraison qui a échoué. L'événement * inscrit l'endpoint à tous les événements.