Passer au contenu principal

Faire livrer par un coursier Stuart

Connectez votre compte Stuart à XPRIO pour faire livrer vos commandes par un coursier quand vous n'avez pas de livreur, ou pour absorber les coups de feu. Disponible en France, au Royaume-Uni et en Pologne, dans les grandes villes.

Écrit par XPRIO

Stuart met à votre disposition ses coursiers indépendants, sans passer par une plateforme de commande : le client commande dans votre appli, à votre nom, et Stuart ne fournit que le livreur. Vous payez chaque course au tarif Stuart, sans commission sur vos ventes.

Dans XPRIO, cela s'appelle un coursier partenaire. Vous le connectez une fois pour votre entreprise, puis vous choisissez, établissement par établissement, s'il livre toutes vos commandes ou seulement en renfort de vos livreurs.

Ce qu'il faut savoir avant de commencer

  • Le compte Stuart est le vôtre. Vous le créez chez Stuart, et c'est Stuart qui vous facture chaque course. XPRIO ne prend rien.

  • Le client paie vos frais de livraison, ceux de votre établissement, encaissés avec sa commande. Le coût de la course Stuart est facturé à part, selon la distance, la taille du colis et l'heure. Si vos frais sont plus bas que la course, la différence est à votre charge ; s'ils sont plus hauts, vous la gardez. Une fois connecté, XPRIO vous montre le prix TTC d'une course type.

  • Le paiement en ligne est obligatoire. Un coursier partenaire n'encaisse rien. Les modes coursier partenaire ne s'activent que si le paiement par carte en ligne (Stripe) est configuré dans votre appli. Configurer vos moyens de paiement

  • Pays couverts : France, Royaume-Uni et Pologne, dans les grandes villes où Stuart opère (129 villes en 2025). XPRIO ne propose Stuart que pour les établissements de ces pays et vérifie chaque adresse au moment du panier.

  • Une carte bancaire doit être enregistrée chez Stuart avant la première course, y compris sur le compte de test. Sans carte, Stuart refuse de créer la livraison.

  • Pas de code de remise avec Stuart : la preuve de livraison est celle du coursier Stuart (signature ou photo).

  • Une annulation peut être facturée une fois qu'un coursier est affecté. XPRIO vous prévient avant de confirmer.

Étape 1 : ouvrir vos comptes Stuart

Stuart fournit deux tableaux de bord, avec une inscription séparée pour chacun :

  • Compte de test sur dashboard.sandbox.stuart.com : courses simulées, rien de facturé, disponible immédiatement. C'est là que vous ferez vos essais.

  • Compte réel sur dashboard.stuart.com : demandez l'ouverture sur stuart.com (bouton Devenir client ou équivalent). Stuart vous rappelle pour valider votre activité, puis vous ouvre l'accès.

Dans les deux cas, une fois connecté :

  1. Cliquez sur votre avatar en haut à droite, puis Mon compte.

  2. Dans le menu de gauche, cliquez sur Facturation et enregistrez une carte bancaire. Sur le compte de test, n'importe quelle carte de test convient (sauf American Express), par exemple 4242 4242 4242 4242 avec une date d'expiration future et un code à trois chiffres. Sur le compte réel, votre vraie carte ou vos coordonnées de facturation selon votre contrat.

Étape 2 : récupérer vos clés

  1. Dans Mon compte, menu de gauche, cliquez sur API.

  2. Si la page affiche Pas d'identifiants d'API, cliquez sur Générer maintenant.

  3. La section Identifiants API affiche trois lignes, chacune avec une icône de copie :

    • ID Client : une longue suite de caractères (c'est le « Client ID »).

    • Clé secrète API : une autre longue suite (c'est le « Client secret »). Ne la partagez avec personne.

    • ID de compte Stuart : un nombre à six chiffres. Vous n'en aurez pas besoin dans XPRIO.

Les valeurs affichées sont tronquées à l'écran : utilisez toujours l'icône de copie, jamais la sélection à la souris. Le compte de test et le compte réel ont chacun leurs propres clés.

Étape 3 : connecter Stuart à XPRIO

  1. Dans XPRIO, menu de gauche, ouvrez App Configuration puis Coursiers partenaires.

  2. Sur la carte Stuart, cliquez sur Connecter.

  3. Dans Environnement, choisissez Test pour les clés du compte de test, Production pour celles du compte réel.

  4. Collez l'ID Client dans Client ID et la Clé secrète API dans Client secret. L'icône en forme d'œil permet d'afficher le secret pour vérifier.

  5. Laissez Clé d'authentification des webhooks vide pour l'instant (étape 4).

  6. Cliquez sur Enregistrer et tester. XPRIO se connecte à Stuart, vérifie que l'adresse de votre établissement est desservie et demande un devis à blanc. Si la carte passe à Connecté (test) ou Connecté (production), c'est bon. Un message rouge reprend sinon la réponse de Stuart : clés incomplètes, ou établissement hors des zones Stuart.

Une fois connecté, la carte affiche « Course type depuis votre établissement (environ 1,5 km) » avec le prix TTC réel renvoyé par Stuart.

Étape 4 : activer les notifications en temps réel (recommandé)

Sans cette étape, XPRIO relit l'état de chaque course toutes les 20 secondes : cela fonctionne. Avec, Stuart prévient XPRIO instantanément à chaque changement (coursier affecté, position, commande récupérée, livrée).

  1. Dans XPRIO, rouvrez la fenêtre Stuart (Modifier sur la carte). Copiez l'URL de notification à déclarer chez le fournisseur.

  2. Toujours dans cette fenêtre, inventez une clé longue (par exemple 20 caractères sans espace), collez-la dans Clé d'authentification des webhooks, puis Enregistrer et tester.

  3. Dans le tableau de bord Stuart, Mon compte, API : sous la section Identifiants, la section Webhooks affiche Pas de Webhooks. Cliquez sur + Ajouter un nouvel endpoint.

  4. Collez l'URL dans URL du webhook. Dans Header d'authentification, tapez exactement Authentication-Key (sans ce nom, Stuart n'envoie pas la clé et XPRIO refuse les événements). Dans Clé d'authentification, collez la même clé que dans XPRIO. Cochez tous les événements V2 (job, delivery, driver). Sauvegardez.

La carte Stuart dans XPRIO passe à « Notifications temps réel actives » dès la première course.

Étape 5 : choisir le mode de chaque établissement

  1. Dans XPRIO, menu Établissements, ouvrez la fiche de l'établissement (Modifier), puis l'onglet Livraison et services.

  2. Vérifiez que le service Livraison est activé.

  3. Dans la section Qui livre vos commandes, choisissez :

    • Mes livreurs : rien ne change.

    • Mes livreurs + coursier partenaire en renfort : vos livreurs restent prioritaires ; un bouton Appeler un coursier partenaire apparaît sur chaque commande en livraison payée en ligne tant qu'aucun livreur n'est assigné. Option Appeler automatiquement un coursier partenaire si aucun livreur ne prend la commande, avec un délai de 5 à 30 minutes après « prête ».

    • Coursier partenaire uniquement : chaque commande en livraison est confiée automatiquement au coursier Stuart, au moment que vous choisissez (Quand commander le coursier). Le client ne voit que le paiement en ligne.

    Si les cartes partenaire sont grisées avec « Paiement en ligne requis », activez d'abord Stripe dans App Configuration, Moyens de paiement.

  4. Choisissez Stuart dans Fournisseur.

  5. En mode « coursier partenaire uniquement », choisissez les frais facturés au client : Mes frais fixes ou Le prix du coursier (+ marge). En mode renfort, le client paie toujours vos frais fixes.

  6. Ajoutez si besoin une consigne au coursier pour le retrait et choisissez si le pourboire du client est reversé au coursier. Enregistrez.

Dans le Live et côté client

Sur la commande, le bloc Coursier partenaire affiche le coursier Stuart dès son affectation, son téléphone, son étape (Coursier en route, Coursier au magasin, Récupérée, Chez le client, Livrée) et l'heure d'arrivée estimée. Avant de commander, la fenêtre de confirmation vous montre le coût de la course TTC.

La commande passe en En livraison quand le coursier la récupère et en Livrée à la remise, sans intervention. Vous pouvez annuler le coursier tant qu'il n'a pas récupéré la commande. En cas d'annulation par Stuart ou de retour de la commande, vous recevez une notification, un son et un message dans le Live, et vous pouvez relancer un coursier ou assigner un de vos livreurs.

Dans votre appli, le client voit une carte contact Coursier partenaire avec le prénom du coursier, un bouton d'appel, un lien de suivi, et sa position en temps réel sur la carte. Sur un établissement en mode « coursier partenaire uniquement », le panier n'affiche que le paiement par carte.

Questions fréquentes

Puis-je tester sans course réelle ? Oui, avec le compte de test connecté en environnement Test. Dans le tableau de bord de test, l'onglet Scénario idéal permet de faire avancer une course simulée étape par étape et de voir le résultat dans le Live.

Stuart refuse la course avec une erreur de paiement ? Aucune carte n'est enregistrée dans Facturation de ce compte, ou elle est expirée. Ajoutez-en une et réessayez.

Articles liés

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