Démarrer en tant que partenaire plateforme logicielle
Ce guide s'adresse aux entreprises qui développent un logiciel utilisé par de nombreux marchands, comme un WMS, une plateforme de boutique en ligne, un système de gestion des commandes ou un logiciel d'expédition, et qui veulent proposer le QrX Payment on Delivery dans leur produit. Vous intégrez une seule fois. Chaque marchand connecte ensuite son propre compte QrX à votre logiciel en quelques clics via QrX Connect, sans copier de clés API.
Dans PortalX, il s'agit du parcours de configuration Je développe des logiciels et je souhaite connecter mes marchands du guide de démarrage (Paramètres > Entreprise > Démarrage).
Comment ça marche
Chaque marchand conserve son propre compte QrX, son prestataire de paiement et sa configuration de transporteurs.
Le marchand clique sur « Connect QrX » dans votre logiciel, se connecte sur QrX, choisit un canal de vente et clique sur Allow (autoriser).
Votre serveur reçoit la clé API de ce seul canal et appelle l'API publique QrX au nom du marchand.
Le paiement du consommateur à la porte reste toujours sur go.qr-x.app. Votre logiciel ne touche jamais au paiement lui-même.
1. Configurez votre propre compte
Complétez les informations de votre entreprise. QrX reprend le nom de l'entreprise, l'adresse et le numéro de TVA ou d'immatriculation (Chambre de commerce) de votre inscription. Si une information manque ou a changé, cliquez sur Demandez à QrX dans l'étape et QrX la complète pour vous. L'étape se coche lorsque toutes les informations sont connues.
Invitez vos développeurs dans Paramètres > Équipe et accès > Utilisateurs.
2. Demandez votre identifiant client QrX Connect
Cliquez sur Demandez à QrX dans l'étape (cela ouvre le chat), ou utilisez qrx.eu/api. Communiquez à QrX le nom de votre produit et votre URL de callback HTTPS. Chaque intégration reçoit son propre identifiant client (client id).
3. Développez la connexion
Redirigez le marchand vers https://portal.qr-x.app/oauth/authorize avec votre client id, votre URL de callback, un state aléatoire et un challenge PKCE (S256).
Sur votre callback, vérifiez le state et échangez le code : POST https://api.qr-x.net/api/v1/oauth/token (authorization_code avec code_verifier). Le code ne fonctionne qu'une fois.
Stockez la clé API du canal renvoyée, chiffrée, sur votre serveur.
Échangez-la contre un jeton d'accès avec POST /api/v1/auth/token et appelez l'API comme pour toute intégration marchand.
Détails : « QrX Connect : connecter votre plateforme avec OAuth » et la référence sur qrx.eu/api.
4. Créez une transaction de test pour ce marchand
Connectez un marchand de test (votre propre compte QrX convient) avec QrX Connect.
Créez une transaction en mode test avec une étiquette : POST /api/v1/transactions.
Abonnez-vous aux webhooks de ce canal et vérifiez l'en-tête X-QrX-Signature.
Scannez le QR code de l'étiquette de test et effectuez un paiement test à la porte.
5. Certifiez les étiquettes et les webhooks avec QrX
Avant que les marchands utilisent votre intégration en production, QrX vérifie avec vous le flux complet : le rendu des étiquettes sur les imprimantes de vos marchands (PDF ou ZPL, étiquette UPS Standard ou Extended), des nouvelles tentatives qui ne créent jamais de deuxième étiquette, le traitement des webhooks et l'annulation. Planifiez-la via Demandez à QrX dans l'étape.
Partenariat
QrX propose des commissions partenaires pour les activités éligibles. Les conditions sont convenues par partenariat ; consultez « Les partenaires et comment devenir partenaire de QrX ».
Quand contacter notre équipe support
Contactez QrX pour demander ou modifier un client id ou une URL de callback, lorsque l'échange de jeton échoue toujours avec un code valide, ou pour planifier la certification.