Outils développeurs
Recevez des événements, pilotez la sandbox et découvrez ce qui s'est réellement passé.
Quatre obstacles séparent l'écriture d'une intégration de la confiance que vous lui accordez : vous ignorez ce que la plateforme vous communiquera, votre ordinateur n'est pas accessible depuis Internet, vous ne pouvez pas provoquer l'échec d'un paiement à la demande et vous ne voyez pas la réponse de votre endpoint. Chaque partie de cette section élimine l'un de ces obstacles, dans cet ordre.
Le chemin le plus court vers une intégration fonctionnelle
- 1
Découvrez les informations reçues, puis écrivez le handler
Vérifiez la signature, répondez avec un code
2xx, puis placez le traitement dans une file. Vous trouverez l'enveloppe, le catalogue et cinq handlers fonctionnels dans Webhooks. - 2
Recevez un événement réel sur votre ordinateur
wajub listen --forward-to localhost:3000/webhooks/wajub. Aucun tunnel, aucun déploiement, et la signature est réelle. L'installation nécessite une seule commande, présentée dans CLI. - 3
Produisez les résultats nécessaires
wajub trigger payment.failed, puis le remboursement, puis l'expiration. Lorsqu'un résultat ne peut pas être déclenché par la CLI, un numéro de test le force. - 4
Consultez le résultat
Konsole conserve la requête, l'événement et chaque tentative de livraison, avec le corps renvoyé par votre endpoint.
Les deux commandes qui remplacent la majeure partie d'un environnement de test
wajub listen et wajub trigger, dans deux terminaux, créent une boucle complète d'événements
sans déploiement ni téléphone. Tous les autres outils présentés ici accompagnent ces deux commandes.
Limites de chaque outil
Chaque partie de la boucle possède une limite. Chacune a déjà fait perdre une journée à quelqu'un.
| Apparence | Réalité |
|---|---|
| Un abonnement à tout couvre tous les événements | transaction.* n'est jamais livré et un abonnement * ignore silencieusement les événements de conformité et de prestataire |
| La CLI peut produire tous les événements | Elle en déclenche huit. Les quarante-neuf autres sont produits en manipulant la ressource |
| Le bouton Send test de Konsole prouve que votre handler fonctionne | Son payload place le type dans type au lieu de event. Un handler écrit selon ce test échoue en production |
| Un canal fonctionnel dans la sandbox fonctionne en live | La sandbox accepte tous les opérateurs de son tableau. Votre compte live est limité par vos contrats |
| Konsole affiche toutes les décisions de routage | Le routage existe uniquement en live. Rien n'est visible dans la sandbox |
Choisir selon le symptôme
| Symptôme | Point de départ |
|---|---|
| Je ne connais pas les événements disponibles | Catalogue des événements |
| La vérification de ma signature échoue toujours | Vérification de signature |
| Mon endpoint n'est pas accessible depuis Internet | wajub listen |
| J'ai immédiatement besoin d'un paiement échoué | wajub trigger |
| L'API a renvoyé une réponse que je ne comprends pas | Logs API |
| L'événement a été émis, mais mon handler ne s'est jamais exécuté | Livraisons de webhooks |
| Le paiement a utilisé le mauvais prestataire | Routage |
| Je veux que mon agent écrive correctement l'intégration | Skills pour agents |