Dépannage API et webhooks
Le support API et webhooks de QrX fonctionne le mieux lorsque les demandes incluent des identifiants clairs et des détails techniques expurgés.
Problèmes d'API courants
Mauvais identifiant de marchand, de client ou de canal.
Email ou téléphone du client manquant pour les flux de vérification et de support.
Configuration invalide du montant, de la devise, du pays ou du moyen de paiement.
Endpoint webhook indisponible ou renvoyant une réponse d'échec.
Références de commande en double ou problèmes d'idempotence.
Environnement incorrect, par exemple l'envoi d'identifiants de production vers un endpoint de test.
Que transmettre au support
Transmettez l'environnement, le marchand ou le canal, la référence de commande, l'identifiant de transaction QrX, l'horodatage, l'endpoint, le statut de la réponse, l'identifiant d'événement webhook et un corps de requête ou de réponse expurgé. Supprimez les clés API, jetons, signatures, mots de passe et données personnelles qui ne sont pas nécessaires au débogage.
Vérifications des nouvelles tentatives de webhook
Vérifiez que votre endpoint est joignable, 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 webhooks doivent être idempotents, car des nouvelles tentatives peuvent se produire.
Santé des webhooks et journaux de livraison
Chaque abonnement webhook dans PortalX affiche un statut de santé. Si un endpoint échoue en continu, QrX envoie des emails d'avertissement aux destinataires configurés et désactive automatiquement l'abonnement après environ 24 heures d'échec ; il peut être réactivé dans PortalX une fois l'endpoint corrigé. Utilisez le journal de livraison propre à chaque webhook dans PortalX pour inspecter chaque tentative de livraison, y compris la requête, la réponse et les nouvelles tentatives, avant de contacter le support.
Quand contacter notre équipe support
Contactez directement le support QrX pour les problèmes d'API impliquant des identifiants, la sécurité, des incidents de production, des incohérences de paiement, des échecs de signature de webhook ou des erreurs d'intégration répétées. Ces cas sont toujours traités par une personne.