Passer au contenu principal

Dépannage API et Webhook

Écrit par Hayko

Dépannage API et Webhook

Le support API et webhook de QrX fonctionne mieux lorsque les requêtes incluent des identifiants clairs et des détails techniques nettoyés.

Problèmes API Courants

  • Mauvais identifiant marchand, client ou canal.

  • Adresse e-mail ou téléphone client manquant pour les flux de vérification et de support.

  • Montant, devise, pays ou configuration du mode de paiement invalide.

  • Point de terminaison webhook indisponible ou renvoyant une réponse non réussie.

  • Références de commande en double ou problèmes d'idempotence.

  • Environnement incorrect, comme l'envoi de données de production à un point de terminaison de test.

Que Fournir au Support

Envoyez l'environnement, le marchand ou canal, la référence de commande, l'identifiant de transaction QrX, l'horodatage, le point de terminaison, le statut de la réponse, l'identifiant de l'événement webhook et le corps de la requête ou réponse nettoyé. Supprimez les clés API, jetons, signatures, mots de passe et données personnelles non nécessaires au débogage.

Vérifications de Nouvelle Tentative Webhook

Vérifiez que votre point de terminaison est accessible, renvoie rapidement un statut de succès, valide correctement les signatures et gère en toute sécurité les événements webhook en double. Les consommateurs de webhook doivent être idempotents car des nouvelles tentatives peuvent survenir.

Quand Fin Doit Escalader

Fin doit escalader les problèmes API impliquant les identifiants, la sécurité, les incidents en production, les incohérences de paiement, les échecs de signature webhook ou les erreurs d'intégration répétées.

Avez-vous trouvé la réponse à votre question ?