Passer au contenu principal

Intégrations et API

Ce que les marchands et les plateformes peuvent automatiser avec l'API QrX et les webhooks, y compris la fiabilité des webhooks et les canaux marchands.

Écrit par Hayko

Intégrations et API

QrX accompagne les marchands et les plateformes qui souhaitent automatiser le Payment On Delivery grâce aux intégrations API et webhooks. Les intégrations peuvent créer des commandes avec paiement, recevoir les changements de statut et relier la confirmation de paiement QrX aux flux de livraison et de support.

Ce que vous pouvez intégrer

  • Création de commandes avec les coordonnées du client, le montant, la devise, la référence marchand et la référence de livraison.

  • Statut de paiement incluant les états créé, en attente, payé, échoué, expiré, annulé et remboursé.

  • Données de suivi lorsque votre système de livraison ou votre transporteur fournit des références de suivi.

  • Vérification des coordonnées client pour les flux email, téléphone, WhatsApp et repli SMS.

  • Flux de remboursement lorsque votre prestataire de paiement et la configuration marchand le permettent.

  • Étiquettes d'expédition pour les marchands connectés à un transporteur, y compris la création d'étiquettes UPS via l'API.

  • Webhooks pour les événements liés au paiement, à la commande et à la livraison.

Fiabilité des webhooks

Les abonnements webhook dans PortalX affichent un statut de santé. Si un endpoint échoue de manière répétée, QrX avertit les destinataires configurés par email et désactive automatiquement l'abonnement après environ 24 heures d'échec continu afin qu'il puisse être corrigé et réactivé. Chaque webhook dispose d'un journal de livraison dans PortalX montrant chaque tentative, la requête et la réponse, ainsi que les nouvelles tentatives, ce qui permet de diagnostiquer les problèmes d'intégration sans contacter le support.

Canaux marchands

Un marchand peut exploiter plusieurs canaux ou comptes clients dans QrX. Assurez-vous que chaque requête API inclut les identifiants corrects de marchand, de client, de canal ou de compte requis par votre intégration. Cela garde les paiements, les conversations de support et les données de suivi reliés au bon contexte commercial.

Support pour les développeurs

Lorsque vous contactez le support au sujet d'un problème d'API ou de webhook, indiquez l'heure de la requête, l'environnement, le marchand ou le canal, la référence de commande, l'identifiant de transaction, l'identifiant d'événement webhook, le statut de la réponse et un corps de requête ou de réponse expurgé. N'envoyez pas de clés secrètes par chat ou par email.

Flux UPS et transporteurs

QrX est le seul partenaire UPS Payment On Delivery en Europe. Les flux UPS éligibles peuvent utiliser QrX pour encaisser un paiement numérique avant la remise d'un colis, selon la configuration du marchand et la disponibilité du transporteur.

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