Intégrations et API

QrX connecte votre boutique aux prestataires de paiement et aux réseaux de livraison via une seule couche partagée. Vous pouvez vous connecter via une intégration de plateforme prête à l'emploi ou développer directement sur l'API QrX. Les deux options intègrent votre activité dans le même flux de paiement et de livraison QrX, et vous n'avez pas besoin de remplacer votre boutique existante.

Intégrations disponibles

L'annuaire des intégrations sur qrx.eu/integrations répertorie actuellement :

Shopify (commerce) : l'application QrX pour Shopify réunit vos commandes Shopify, le statut des paiements et les informations de livraison dans un même flux de travail, et marque les commandes comme payées lorsque le client paie à la porte. Consultez l'article « QrX pour Shopify ».
Stripe (paiements) : Stripe traite le paiement via votre propre compte Stripe. QrX coordonne la demande et la confirmation de paiement avec le parcours de livraison.
MultiSafepay (paiements) : utilisez MultiSafepay pour le traitement des paiements pendant que QrX relie le statut du paiement à la livraison.
UPS (livraison) : QrX est le partenaire officiel UPS pour le Payment on Delivery en Europe et peut créer des étiquettes UPS. Consultez l'article « UPS Payment on Delivery avec QrX ».

Mollie est également un prestataire de paiement intégré pour le Payment on Delivery QrX. Les moyens de paiement, les pays et les services de transport disponibles dépendent toujours de votre compte prestataire, de vos marchés de destination et de la configuration QrX. Si votre plateforme, votre PSP, votre transporteur ou votre réseau de consignes n'est pas répertorié, demandez-le via la page des intégrations ou réservez une démo.

Développer avec l'API publique QrX

Style : REST avec JSON, URL de base https://api.qr-x.net, spécification OpenAPI disponible.
Authentification : créez une clé API par canal de vente dans PortalX, sous Settings, Merchant channels (Paramètres, Canaux marchands). Échangez-la contre un jeton Bearer de courte durée avec POST /api/v1/auth/token (valable une heure).
Transactions : créez une transaction Payment on Delivery, consultez ses détails ou son statut de paiement, marquez-la comme expédiée avec les informations de suivi, ou annulez-la.
Données de référence : consultez les transporteurs, pays, langues, méthodes d'expédition et adresses d'expéditeur.
Produits et retours : gérez votre catalogue de produits et traitez les demandes de retour.
Stock en entrepôt : lire les niveaux de stock, les articles de stock et les emplacements, enregistrer une correction de stock et recevoir les événements stock/adjusted et stock/low. Voir "API de stock et d'entrepôt" et "Webhooks de stock et d'entrepôt".
Webhooks : abonnez-vous à des événements, vérifiez les envois signés, consultez le journal des envois, renvoyez des envois et renouvelez les secrets de signature.
Mode test : créez des transactions avec testMode: true pour tester le flux complet sans paiements ni versements réels.
QrX Connect (OAuth) : des plateformes comme des applications, des systèmes WMS ou des boutiques sur mesure peuvent permettre à un marchand de lier un canal QrX sans coller de clé API.

La référence complète et toujours à jour, avec des exemples de code (cURL, Node.js, C#, PHP, Python) et une collection Postman prête à l'emploi, est disponible sur qrx.eu/api. Commencez par l'article « Démarrage rapide pour les développeurs : API publique et webhooks QrX ».

Fiabilité des webhooks

Les webhooks font foi pour le statut final d'une transaction, car le traitement du paiement peut aboutir ou échouer après le retour de votre requête de création. Les abonnements webhook dans PortalX affichent un état 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'échecs continus, afin qu'il puisse être corrigé et réactivé. Chaque webhook dispose d'un journal des envois indiquant chaque tentative, la requête et la réponse, ainsi que les nouvelles tentatives.

Canaux marchands

Un marchand peut gérer plusieurs canaux de vente dans QrX. Chaque clé API appartient à un seul canal, et tout ce qui est créé avec elle (transactions, étiquettes, webhooks) reste lié à ce canal. Utilisez une clé distincte par canal.

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 (test ou live), le canal marchand, la référence de commande, l'identifiant de transaction, l'identifiant d'envoi du webhook, le statut de la réponse et un corps de requête ou de réponse expurgé. N'envoyez jamais de clés API, de jetons d'accès ou de secrets de webhook par chat ou email. Consultez aussi « Dépannage de l'API et des webhooks ».