Démarrer avec votre propre boutique en ligne ou système
Ce guide s'adresse aux marchands qui vendent sur une boutique en ligne autre que Shopify (par exemple WooCommerce, Magento, Lightspeed ou une boutique sur mesure) ou qui utilisent leur propre système de commandes, et qui souhaitent le QrX Payment on Delivery et des étiquettes d'expédition. Votre système envoie les commandes à QrX via l'API publique QrX, ou vous les importez depuis une feuille de calcul. Le client passe commande sans payer, scanne le QR code QrX sur le colis à la porte et paie via votre propre prestataire de paiement.
Dans PortalX, il s'agit du parcours de configuration Je vends sur une autre boutique en ligne ou sur mon propre système du guide de démarrage (Paramètres > Entreprise > Démarrage).
1. Configurez votre entreprise
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.
Ajoutez votre entrepôt comme adresse d'expéditeur dans Paramètres > Opérations > Adresses. Donnez-lui un code court : votre système utilise ce code dans les appels API.
Connectez votre fournisseur de paiement (Stripe, Mollie ou MultiSafePay) dans l'onglet Paiements du canal.
2. Configurez l'expédition
Connectez un transporteur dans Paramètres > Opérations > Prestataires de services de livraison et ajoutez des profils de méthode. Chaque profil de méthode a un code pour les appels API.
Connectez votre imprimante d'étiquettes dans Paramètres > Préférences > Impression (PrintNode), ou laissez votre propre système imprimer les étiquettes que QrX renvoie.
Créez une règle d'expédition dans Paramètres > Opérations > Règles d'expédition. Pour les commandes API, vous pouvez choisir d'appliquer les règles.
3. Connectez votre système avec l'API
Copiez la clé API de votre canal. Paramètres > Entreprise > Canaux marchands, ouvrez le canal, onglet Paramètres, Régénérer la clé API (Regenerate API Key). QrX stocke la clé sous forme hachée : elle n'est donc affichée en entier qu'une seule fois. Conservez-la sur votre serveur, jamais dans un navigateur ou une application. Cliquez sur Marquer comme terminé (Mark as done) dans l'étape une fois que vous l'avez.
Obtenez votre premier jeton d'accès. POST /api/v1/auth/token avec l'en-tête QrX-MerchantChannel-API-Key. Le jeton est valable 3600 secondes.
Créez votre première transaction de test. POST /api/v1/transactions avec le montant, les détails de la commande et, si vous souhaitez une étiquette dans le même appel, un bloc parcel avec vos codes de méthode et d'expéditeur. Utilisez d'abord le mode test. HTTP 201 signifie que QrX a accepté la commande, pas qu'elle est payée.
S'abonner aux webhooks. Paramètres > Avancé > Webhooks, ou POST /api/v1/webhooks. Au minimum : transaction payée, annulée et expédition expédiée. Vérifiez l'en-tête X-QrX-Signature à chaque livraison.
Recevez votre premier webhook. Utilisez Envoyer un test (Send Test) dans l'éditeur de webhook et consultez les journaux de livraison (Delivery Logs).
La référence complète avec des exemples de code se trouve sur qrx.eu/api. Consultez aussi « Démarrage rapide pour les développeurs : API publique QrX et webhooks ».
Créer vos commandes sans développeur
Ce parcours affiche aussi les étapes pour créer des commandes dans PortalX, utiles pour tester ou si vous n'avez pas encore de développeur :
Créer une transaction à la main : Transactions > Créer une transaction.
Importer les commandes à partir d'une feuille de calcul : dans Transactions, utilisez le menu Importer (Import) avec un export CSV ou Excel de votre boutique. Les règles d'expédition s'appliquent aux commandes importées.
Ajoutez vos produits dans Produits > Catalogue pour remplir plus vite les lignes de commande (facultatif).
4. Tenez vos clients informés
Personnalisez votre page Track and Trace : Paramètres > Opérations > Suivi de colis.
Personnalisez vos messages clients : Paramètres > Opérations > Modèles.
Activer les notifications de livraison par SMS (facultatif, payant, désactivé par défaut) : Canaux marchands, ouvrez le canal, onglet Paramètres, SMS.
Ouvrez votre Centre de messages : Paramètres > Opérations > Message Centre.
5. Soyez payé à la porte
Effectuez un paiement test à la porte en scannant le QR code d'une étiquette de test. Cela ne coûte rien.
Exigez éventuellement un PIN sur la page de paiement.
Demandez à QrX de passer en production via Discutez avec QrX.
Votre premier paiement réel à la porte coche la dernière étape.
Conseils pour une intégration propre
Envoyez votre propre identifiant de commande de la boutique afin de retrouver les commandes dans les deux systèmes.
Considérez les webhooks comme la source de vérité pour les statuts payé et annulé ; le paiement peut aboutir bien après la réponse de votre appel de création.
Utilisez les endpoints de référence (/api/v1/reference/carriers, shipping-methods, senders) plutôt que des identifiants codés en dur.
Gardez un canal marchand par boutique en ligne : chaque canal a sa propre clé API, son propre prestataire de paiement et sa propre personnalisation.
Quand contacter notre équipe support
Contactez le support QrX lorsque les demandes de jeton échouent toujours avec une clé valide, lorsque des webhooks sont désactivés après des échecs répétés et que vous ne trouvez pas la cause, ou lorsque vous êtes prêt à passer en production.