Passer au contenu
Français
Accèder à ShippyPro
  • Il n'y a aucune suggestion car le champ de recherche est vide.

Comment fonctionne Checkout

Voici comment notre outil Checkout peut faciliter l'expérience d'expédition

 

Permettre à vos clients de choisir le mode de livraison qu'ils préfèrent peut améliorer leur expérience d'achat et les encourager à acheter à nouveau sur vos canaux de vente. ShippyPro Checkout est l'outil parfait pour augmenter vos conversions e-commerce ! Afficher notre carte des points de dépôt offre à vos clients bien plus de flexibilité.

Sommaire :

  • Avant de commencer
  • Avantages de l'utilisation de Checkout
  • Tarifs
  • Marketplaces et transporteurs pris en charge
  • Configuration
  • FAQ

1. Avant de commencer

Checkout est une suite d'API qui permet à vos clients de choisir eux-mêmes un point de collecte en le sélectionnant directement lors du paiement dans votre boutique.

2. Avantages de l'utilisation de Checkout

Intégrer des points de dépôt (PUDO et casiers) dans le processus de paiement via un module ou une API vous aidera à :

  • Réduire les coûts de stockage : avec un taux de réussite de première tentative de livraison proche de 100 %, vous éliminez les coûts supplémentaires appliqués par les transporteurs pour les colis en attente.
  • Économiser sur les coûts d'intégration : l'équipe informatique n'aura pas besoin d'intégrer les API du service de retrait pour chaque transporteur séparément.
  • Augmenter le taux de conversion : en offrant une disponibilité 24h/24 et 7j/7, une proximité avec le lieu de travail et une durée de stockage allant jusqu'à 5 jours ou plus. Tous ces avantages réduisent les taux d'abandon de panier.

Si cela est appliqué au processus de retour, cela signifie des étiquettes de retour plus pratiques et, là encore, une flexibilité accrue pour vos clients.

3. Tarifs

Tous les plans (Professional et Enterprise) incluent 500 sessions de paiement gratuites par mois, réinitialisées le premier jour de chaque mois. Une session de paiement est comptabilisée à chaque fois qu'un appel API est exécuté pour mettre à jour les informations des points de retrait lors du paiement.

Par exemple :

  • lorsqu'un client saisit son adresse et que la carte se charge avec les points de retrait à proximité, cela compte comme une session ;
  • si le client modifie ensuite son adresse ou déplace le repère sur la carte et que les points de retrait sont mis à jour, cela compte comme une session supplémentaire.

Après 500 sessions, la structure de coûts suivante s'applique :

Sessions de paiement / mois Coût mensuel Maps
Jusqu'à 500 Gratuit
501–1 000 29 €
1 001–3 000 79 €
3 001–6 000 129 €
6 001+ 0,03 € par chargement supplémentaire

4. Marketplaces et transporteurs pris en charge

Transporteurs pris en charge

Vous pouvez retrouver la liste complète des transporteurs ici en cliquant sur la fonctionnalité « Points de dépôt ».

Voici la liste de tous les transporteurs pris en charge et leurs points de dépôt respectifs :

  • BRT API : FermoPoint
  • Colis Privé : Point Relais
  • Colissimo : Point Retrait
  • Correos : Citypaq
  • Correos Express
  • Chronopost : Points Relais Pickup
  • Chronopost Portugal : DPD PT Pickup
  • DHL EXPRESS : DHL Service Point
  • DHL Parcel : DHL Service Point
  • FedEx : Ship Center
  • InPost : Locker Inpost 24
  • Lietuvos Pastas v2
  • Mondial Relay : Point Relais
  • MRW : Point Corner / Point Office
  • Nexive : Nexive inZona
  • Poste Italiane : Rete Punto Poste
  • Relais Colis : Point Relais Colis
  • San Marino Mail : Drop Off Points
  • Seur : Pickup Points
  • TNT Italy : TNT Point
  • UPS : Access Point

Marketplaces pris en charge

Toutes les marketplaces et sites web personnalisés sont compatibles, mais vous aurez besoin d'un module sur mesure développé par votre équipe informatique.

Shopify

Si vous utilisez Shopify, vous devrez télécharger l'application Atlas pour gérer la carte PUDO au moment du paiement.

Pour intégrer les points PUDO dans votre Checkout Shopify, consultez notre guide dédié sur Atlas Pickup Points : Comment utiliser Atlas Pickup Points avec ShippyPro

5. Configuration

⚠️ Le processus de configuration décrit ci-dessous nécessite un effort important. Il est donc recommandé uniquement aux personnes disposant d'une équipe de développement capable de créer un module personnalisé. ⚠️

Pour utiliser Checkout, suivez ces étapes :

  • Rendez-vous dans  Checkout > Paramètres et :
    • Sélectionnez les transporteurs que vous souhaitez afficher au moment du paiement
    • Attribuez un transporteur à un pays spécifique (facultatif)
  • Lancez GetDropOffPoints : il renvoie les points de collecte les plus proches pour tous les transporteurs connectés, ainsi que des informations telles que les horaires d'ouverture, etc., afin que vous puissiez les afficher au client au moment du paiement (sur une carte ou sous forme de liste). Vous pouvez effectuer une recherche par localisation en utilisant la ville, le code postal et le pays, ou bien les coordonnées de latitude et longitude ; vous pouvez également limiter la recherche à des transporteurs spécifiques, définir une limite sur le nombre de résultats retournés (jusqu'à 50, 20 par défaut) et définir le rayon de recherche en kilomètres (1 à 20 km).
  • Vous avez alors 2 possibilités :
    •  Expédition via API : transmettre le Point ID dans le champ CarrierOption correspondant de l'appel Ship ; 
    •  Expédition via la plateforme : un appel API supplémentaire, ChoosePoint, est nécessaire pour associer correctement le point de retrait sélectionné à la commande entrante. Ce processus garantit que l'option transporteur PUDO est automatiquement présélectionnée lors de la création de l'expédition, évitant ainsi toute sélection manuelle. 
     

    Voici un exemple du processus :

    1. Vous pouvez implémenter un callback qui vous permet de recevoir et de gérer les informations du Point sélectionné par le client final lors du checkout ;

    2. Effectuez un premier appel ChoosePoint avec les informations du Point sélectionné - exemple :

    {
       "Method": "ChoosePoint",
       "Params": {
           "url": "www.........it",
           "point_id": "IT1234",
           "point_name": "IT Cartoleria",
           "point_address": "P.zza Vittorio Veneto 12, 24060, Brusaporto (BG)",
           "courier_name": "BRT",
           "point_type": false,
           "apikey": "1234",
       }
    }
     
     
    3.   Vous recevrez un ID dans la réponse, exemple :
     
    {
       "id": "1234",
       "Result": "OK"
    }
     
    4.  Effectuez un deuxième appel ChoosePoint, avec l'ID reçu précédemment dans le paramètre « selected_id » + votre « order_id » (votre Transaction ID interne). Cette étape est nécessaire pour associer correctement le Point ID fourni au Transaction ID spécifique:
     
    {
       "Method": "ChoosePoint",
       "Params": {
           "url": "www.........it",
           "selected_id": "1234",
           "order_id": "001522"
       }
    }
  • Générez l'étiquette d'expédition : saisissez l'ID du point de collecte choisi par le client dans le champ « Carrier Option » du transporteur lors de l'appel de la méthode Ship.

6. FAQ

Comment puis-je activer Checkout ?
La section Checkout est déjà active dans votre profil.

Puis-je afficher les tarifs saisis sur ShippyPro dans mon checkout ?
Oui, vous pouvez afficher les Live Rates (tarifs en temps réel) au moment du paiement en utilisant l'appel API GetRates, qui renvoie les tarifs de vos transporteurs. Vous devrez ensuite développer un module personnalisé permettant d'appliquer des suppléments ou d'ajuster ces tarifs afin qu'ils correspondent à ceux réellement appliqués à vos clients finaux.

Je ne vois pas les points PUDO pour un transporteur
Vérifiez les identifiants du transporteur dans la page Transporteurs. Si vous avez plusieurs transporteurs, désélectionnez-les un par un dans la page Checkout > Paramètres pour identifier lequel possède des identifiants incorrects.

Nous ne trouvons pas le code postal à partir des coordonnées
Cette erreur indique qu'une saisie imprécise a été effectuée dans la barre de recherche. Veuillez saisir une adresse précise accompagnée du code postal correct afin de faciliter la recherche des points de dépôt.

Puis-je configurer une tarification dynamique ?
Non, il n'est pas possible de configurer une tarification dynamique telle que « livraison gratuite pour les commandes supérieures à un certain montant ».

Je rencontre l'erreur « Ship and Collect feature is not enabled for this user », pourquoi ?

Vous avez épuisé vos 500 cartes gratuites mensuelles, il est donc nécessaire d'activer le forfait à la consommation en cliquant sur Activer le plan dans la section Checkout.

❓ Pourquoi l'erreur « Domain not found » apparaît-elle, ou les paramètres des domaines sont-ils introuvables ?

Vous ne trouvez pas où ajouter les domaines de vos boutiques dans la nouvelle interface ? Vous pouvez toujours accéder directement à la configuration des domaines.

  1. Connectez-vous à votre compte ShippyPro.
  2. Ouvrez la page de configuration des domaines dans un autre onglet du navigateur.
  3. Cliquez sur Add domain pour ajouter le domaine de votre boutique.
  4. Dans Associated ShippyPro Marketplace, sélectionnez la connexion qui importe les commandes de cette boutique.
  5. Enregistrez votre configuration.

Ajoutez séparément chaque domaine de boutique et associez-le à la connexion marketplace correspondante avant de réessayer ChoosePoint.

📌 Remarque : Le paramètre url envoyé dans les deux appels ChoosePoint doit appartenir à la boutique associée à la commande. Si vous gérez plusieurs boutiques, n'envoyez pas le domaine d'une autre boutique.

❓ Comment accéder à l'ancien widget ?

Notre équipe Support peut activer l'ancien widget, qui donne accès aux anciennes fonctions dans Checkout. Pour demander son activation, écrivez à notre équipe Support via le bouton HELP de votre compte.

Si l'enregistrement des domaines renvoie « Operation not permitted », signalez l'erreur même si l'interface affiche « SAVED ». Indiquez les domaines, les étapes suivies, les captures d'écran ou les détails de l'erreur, et précisez si elle apparaît dans une réponse API. L'ouverture de la page de configuration ou l'activation de l'ancien widget ne sont pas des solutions confirmées aux erreurs d'autorisation.

❓ Comment associer un point de retrait PrestaShop à une commande CTT v2 ?

CTT v2 prend en charge les envois vers des points de retrait. L'association automatique du point sélectionné dans PrestaShop nécessite un développement personnalisé : elle n'est pas disponible nativement. Il n'existe pas de script prêt à l'emploi pour cette intégration. Vos développeurs peuvent utiliser GetDropOffPoints pour créer l'interface de sélection des points.

Pour les instructions de connexion, consultez Comment connecter CTT v2 et Comment connecter PrestaShop. Pour la sélection manuelle, consultez Comment ajouter un point de retrait à vos envois.

⚠️ Important : Les informations du point saisies dans la société ou l'adresse du destinataire ne remplacent pas l'option transporteur PUDO requise. Récupérez le PointID via GetDropOffPoints et utilisez-le sans modification. Ne le construisez pas en ajoutant un préfixe de code pays.

Pour les étiquettes créées depuis la plateforme, votre développeur doit suivre ce processus CTT v2/PrestaShop :

  1. Importez une nouvelle commande PrestaShop dans ShippyPro.
  2. Effectuez le premier appel ChoosePoint avec les informations du point sélectionné.
  3. Utilisez l'id de confirmation renvoyé dans un second appel ChoosePoint immédiatement après, pour associer la sélection à la commande.
  4. Vérifiez les options transporteur de la commande dans Ready to Ship : le point de retrait choisi devrait être présélectionné.

Premier appel ChoosePoint — paramètres :

  • url : le domaine configuré de la boutique à laquelle appartient la commande.
  • point_id : le PointID renvoyé par GetDropOffPoints, sans modification.
  • point_name : le nom du point sélectionné.
  • point_address : l'adresse du point sélectionné.
  • courier_name : CTTv2, et non CTT.
  • point_type : le type de point.
  • apikey : votre clé API.

Le premier appel renvoie un id de confirmation. C'est cette valeur qu'il faut envoyer dans selected_id, et non le PointID du point de retrait.

Second appel ChoosePoint — paramètres :

  • url : le même domaine de boutique que dans le premier appel.
  • selected_id : l'id de confirmation renvoyé par le premier appel.
  • order_id : le Transaction ID interne de la commande PrestaShop.

📌 Remarque : Pour ce processus, effectuez le second appel dans les 30 minutes suivant le premier. La commande doit avoir été créée dans PrestaShop moins de trois heures auparavant. Importez d'abord une nouvelle commande, puis effectuez les deux appels l'un à la suite de l'autre. Ces exigences de délai ne suffisent pas, à elles seules, à expliquer l'échec d'une tentative précédente.

❓ ChoosePoint est-il nécessaire pour créer des étiquettes CTT v2 via Ship API ?

Non. Dans la requête Ship, incluez une entrée CarrierOptions avec name cttv2pointid et le PointID non modifié comme value.

❓ Que vérifier si le point n'apparaît toujours pas ?

  • Vérifiez que chaque domaine est enregistré et associé à la connexion qui importe les commandes de sa boutique.
  • Vérifiez que les deux appels envoient le domaine de la boutique à laquelle appartient la commande concernée.
  • Vérifiez que courier_name est CTTv2, que selected_id contient l'id de confirmation renvoyé et que order_id contient le Transaction ID interne.
  • Vérifiez que les deux appels respectent la séquence et les délais ci-dessus.
  • Évitez les connexions PrestaShop en double qui pointent vers le même site et gèrent les mêmes commandes : elles peuvent provoquer des anomalies d'importation.

Si l'association échoue toujours, laissez une commande récente importée dans Ready to Ship, sans générer d'étiquette ni la modifier. Écrivez à notre équipe Support via le bouton HELP de votre compte et fournissez la référence de la commande, les deux appels ChoosePoint avec leurs réponses et la confirmation de la configuration domaine-marketplace.