Konsole
Quatre vues sur ce que votre intégration a réellement effectué.
Konsole est la partie du Dashboard qui répond à la question « que s'est-il passé ? ». Chaque appel d'API, événement, tentative de livraison d'un webhook et décision de routage y est enregistré. Konsole vous permet de les consulter.
Il ne s'agit pas d'une console dans laquelle saisir des commandes. Elle ne propose ni générateur de requêtes ni playground. Vous appelez l'API depuis votre code ou depuis la CLI, puis Konsole vous montre le résultat de cet appel.
Les quatre vues
| Vue | Réponse apportée |
|---|---|
| Vue d'ensemble | Y a-t-il un problème en ce moment ? |
| Logs API | Qu'ai-je envoyé précisément et quelle réponse ai-je reçue ? |
| Webhooks | La plateforme a-t-elle enregistré l'événement, mon endpoint l'a-t-il reçu et a-t-il répondu ? |
| Routing Log | Quel prestataire a traité ce paiement et pourquoi ? Live uniquement |
Les événements ne sont pas une vue à part : ils forment le premier onglet de Webhooks, à côté de Deliveries et d'Endpoints.
Partir du symptôme
| Symptôme | Ouvrir | Rechercher |
|---|---|---|
| Un appel a renvoyé une erreur que vous ne comprenez pas | API logs | La requête, le corps de la réponse, le message d'erreur |
Un paiement est resté pending | Events | La présence de payment.processing et de payment.failed |
| Votre handler ne s'est jamais exécuté | Webhooks, Deliveries | Le code de statut renvoyé par votre endpoint ou l'absence d'une ligne |
| Un paiement a réussi sur le mauvais rail | Routing | La liste des candidats et la raison pour laquelle le premier a été ignoré |
| Une opération est lente sans raison évidente | Overview | Les cartes d'anomalie, puis les logs associés |
La sandbox et le mode live sont deux ensembles distincts
Konsole affiche un seul environnement à la fois selon le sélecteur du Dashboard. Un paiement de sandbox n'apparaît jamais dans les logs du mode live : la sandbox et le mode live sont entièrement séparés. Vous n'avez donc aucun filtre à appliquer et aucun risque de les mélanger.
Le routage n'existe qu'en mode live
La vue Routing est réservée au mode live. Les paiements de sandbox ne passent pas par la sélection d'un prestataire. Aucune décision n'est donc enregistrée.
Qui peut y accéder
Konsole exige l'autorisation View Webhooks. Les actions proposées, comme créer un endpoint, révéler un secret, relancer une livraison, lancer Diagnose ou exporter des logs ou des événements, exigent Manage Webhooks. Un membre de l'équipe qui ne possède aucune de ces autorisations ne voit pas Konsole.
Tarification
Deux actions dans Konsole sont mesurées selon votre plan au lieu d'être illimitées.
| Action | Compteur |
|---|---|
| Exporter des logs ou des événements au format CSV ou JSON | Exports par mois |
| Relancer manuellement la livraison d'un webhook | Répétitions de webhooks par mois |
Les deux compteurs sont calculés par mois et par équipe. Le quota d'exports n'est pas propre à Konsole : toutes les exportations du Dashboard (paiements, transferts, factures, clients, revenus…) puisent dans le même quota. Celui des relances est souvent mal compris : il ne correspond pas au nombre d'endpoints que vous pouvez créer, mais au nombre de relances manuelles que vous pouvez effectuer. Consultez Plafonds et quotas pour connaître la valeur de chaque plan.