DOCS

Magento

Checkout•
AccueilE-commerce mondial Intégration Intégrer Checkout Magento

Checkout pour Magento

Intégrez le plugin Checkout pour Magento.

Avant d'intégrer Zonos Checkout, assurez-vous qu'il fonctionnera comme vous l'attendez. Voici à quoi ressemblera votre expérience lorsque vous utilisez Checkout :

  • Zonos Hello identifiera automatiquement les acheteurs internationaux en fonction de l'emplacement de leur adresse IP. Lorsque les clients internationaux passent au paiement, ils seront redirigés vers Zonos Checkout pour finaliser leur commande.
  • Lors du processus de paiement, nous fournirons un landed cost total, qui inclut l'expédition (basée sur vos propres tarifs d'expédition ou tarifs forfaitaires), les droits, les taxes et les frais de transporteur. En collectant ces coûts pendant le paiement, vos clients n'auront rien de plus à payer à la livraison.
  • Vos clients bénéficieront de la commodité d'une expérience similaire à une commande nationale : finaliser le paiement dans leur langue locale, avec des champs d'adresse adaptés à leur pays spécifique, et la possibilité de payer dans leur devise locale. Les commandes seront protégées contre la fraude.
  • Vous pourrez facilement gérer vos commandes internationales via Magento et Dashboard. Les numéros de suivi seront synchronisés entre les deux plateformes, garantissant une gestion fluide des commandes.
  • Les codes promo Magento ne fonctionneront pas dans Checkout ; cependant, vous pouvez créer des codes promo dans Dashboard pour vos clients internationaux.
    • Vous devez utiliser un code promo unique pour vos clients internationaux. Sinon, vos codes promo ne seront pas importés avec vos commandes internationales et vous remarquerez des écarts lors de l'importation des commandes. Par exemple, vous ne pouvez pas avoir un code promo nommé « CYBER » dans Magento puis créer un code promo également nommé « CYBER » dans Zonos.

Intégrer 

Si vous ne vous êtes pas encore inscrit à Zonos, remplissez notre formulaire de contact commercial pour commencer. Un représentant d'onboarding dédié vous contactera dans les 24 heures pour vous guider tout au long du processus d'intégration une fois votre accord de compte en place.

Intégrez Checkout de manière transparente à votre boutique Magento en suivant les étapes de cette section :

1

Installer l'application Checkout

Pour utiliser Checkout avec Magento, vous devez acheter l'extension sur Magento Marketplace, puis l'installer dans votre terminal avec Composer. Cette approche est plus technique que nos autres plugins en raison de la façon dont Magento gère les extensions. Pour installer l'application :

  1. Téléchargez l'extension Checkout depuis Magento Marketplace.
  2. Téléchargez l'extension Hello depuis Magento Marketplace.
  3. Ouvrez un nouveau terminal et accédez au répertoire racine de votre installation Magento, puis suivez les instructions ci-dessous.

Exécutez la commande suivante pour ajouter Checkout aux dépendances de votre site. Hello sera automatiquement inclus.

1composer require zonos/checkout

Ensuite, exécutez la commande suivante pour activer le module Checkout.

1php bin/magento module:enable Zonos_Checkout

Maintenant, exécutez la commande suivante pour installer l'extension et effectuer les migrations de base de données requises.

1php bin/magento setup:upgrade

Enfin, exécutez la commande suivante pour compiler une nouvelle version de votre site incluant le plugin Checkout.

1php bin/magento setup:di:compile

Note : Checkout dépend de Hello, les commandes ci-dessus installeront donc les deux.

  1. Accédez à votre Magento admin -> Stores -> Configuration -> Zonos -> Zonos Checkout.
  2. Copiez votre clé API Zonos depuis Dashboard et saisissez-la comme Service token.
  3. Copiez votre numéro de compte Zonos depuis Dashboard et saisissez-le comme Store ID number.
  4. Dans Domestic shipping countries, cliquez pour sélectionner tous vos pays domestiques.
  5. Sous Cart item attribute mapping, choisissez les informations que vous souhaitez mapper. Par défaut, Zonos récupérera le poids, le prix, la description et le pays de fabrication de l'article (si disponible). Cette section contient des champs ouverts vers lesquels vos informations d'article peuvent être transmises pour importer les codes HS, la longueur, la largeur, la hauteur ou tout attribut personnalisé au niveau de l'article pouvant être utilisé par Zonos pour des règles spéciales lors du calcul des devis.

Lorsque vous configurez votre application Checkout dans Magento, vous devrez également apporter quelques modifications à vos paramètres généraux Magento.

  1. Accédez à votre Magento admin -> Stores -> Configuration -> General.
  2. Dans la section Allow countries, sélectionnez tous les pays vers lesquels vous souhaitez expédier, internationalement et domestiquement. Si un pays n'est pas sélectionné ici, mais est activé dans Zonos, la commande pourra être finalisée et apparaîtra dans Dashboard, mais échouera à l'importation dans Magento.
  3. Zonos recommande également de sélectionner tous les pays sauf les États-Unis dans la section Zip/postal code is optional for. Cela réduit les erreurs lors de la finalisation des commandes, car certains pays n'utilisent pas ou n'exigent pas de codes postaux. De plus, comme Checkout est livré avec la protection contre la fraude de Zonos, vous n'encourrez pas de risque supplémentaire en supprimant cette exigence.

Hello est ajouté avec l'installation de l'application Checkout. Suivez les instructions de configuration ci-dessous pour Hello.

  1. Accédez à votre Magento admin -> Stores -> Configuration -> Zonos -> Zonos Hello.
  2. Copiez votre Hello site key depuis Dashboard et saisissez-la comme Site Key.
  3. Si vous souhaitez que Hello convertisse la devise, collez vos sélecteurs CSS dans le champ Currency conversion selectors. Plusieurs sélecteurs sont séparés par une virgule, p. ex. .price,.__current-price,.__subtotal,.__original-price.
    1. Si la devise de base de votre boutique n'est pas USD, indiquez à Hello la devise de base de votre boutique dans Dashboard -> Hello.
  4. Si vous devez Hide domestic elements pour vos clients internationaux, saisissez les sélecteurs CSS des éléments que vous souhaitez masquer, p. ex. .nav-6,.action-add.

Facultatif — Les paramètres suivants sont des paramètres avancés. Des valeurs par défaut sont en place, aucune action n'est donc nécessaire. Si vous souhaitez apporter des ajustements, suivez ces directives :

  1. Accédez à votre Magento admin -> Stores -> Configuration -> Zonos -> Zonos Checkout.
  2. Ajustez selon vos préférences :
    1. Create invoice on import — Défini sur Yes par défaut. Zonos créera une facture lors de l'importation de la commande. Si vous choisissez de désactiver cette fonctionnalité, vous devrez créer votre propre facture, et Zonos définira une suspension de révision de fraude au statut zonos_hold. Une fois la fraude levée, nous reviendrons au statut précédent.
    2. Customer login — Défini sur No par défaut. Si vous souhaitez exiger un compte pour le paiement, passez à Yes. Vous devrez également accéder à Customer configuration -> Login options et mettre à jour Redirect Customer to Account Dashboard after Logging In sur No.

Maintenant que vous avez configuré votre compte et votre application, vous êtes prêt à tester votre intégration. Vous devrez activer Checkout et Hello dans Magento pendant les tests. Pour ce faire :

  1. Accédez à votre Magento admin -> Stores -> Configuration -> Zonos -> Zonos Checkout.
  2. Passez Enabled à Yes.
  3. Passez à Zonos Hello dans le menu de gauche.
  4. Passez Enabled à Yes.

Si vous n'êtes pas encore prêt à passer en production, n'oubliez pas de repasser ces options à No une fois les tests terminés. Après avoir terminé les tests, activez Zonos en utilisant les mêmes étapes ci-dessus.

Besoin d'aide ?

Si vous avez des questions, veuillez contacter notre équipe d'assistance. Si vous travaillez actuellement avec un Project Manager Professional Services pour l'onboarding de votre compte, contactez-le pour obtenir de l'aide.

Désinstaller Checkout 

La désinstallation des applications doit être effectuée par un développeur Magento expérimenté via Composer. Exécutez cette commande pour désinstaller Checkout et Hello :

1php bin/magento module:uninstall Zonos_Checkout Zonos_Hello

Foire aux questions 

Les informations produit peuvent avoir un impact sur le montant des droits et taxes dus et sur le coût d'expédition. Plus vous fournissez d'informations produit à Zonos, plus le devis renvoyé sera précis. Zonos peut générer un devis même lorsque ces informations ne sont pas disponibles, mais recommande de fournir les détails produit clés suivants pour améliorer la précision :

  • Poids : Le poids impacte votre coût d'expédition, ce qui peut affecter les droits ou taxes. Les poids dans vos fiches produit Magento sont automatiquement utilisés par Zonos lorsqu'ils sont présents.
  • Dimensions : Les dimensions peuvent impacter votre coût d'expédition, ce qui peut affecter les droits ou taxes. Zonos peut utiliser les dimensions produit (longueur, largeur et hauteur) définies sur chaque produit dans Magento, mais vous devez les mapper dans l'application Zonos pour une intégration correcte.
  • Codes HS : Les codes HS impactent les taux de droits et peuvent parfois affecter les taxes. Zonos peut utiliser les codes HS définis dans vos fiches produit Magento, mais vous devez mapper le champ code HS dans l'application Zonos.
  • Pays d'origine : Le pays d'origine d'un produit impacte les taux de droits et peut affecter les taxes. Le pays d'origine défini dans vos fiches produit Magento est automatiquement utilisé par Zonos lorsqu'il est présent.

Détails produit transmis à Zonos par Magento 

Détails produit↕Poids↕Dimensions↕Code HS↕Pays d'origine↕
Transmis automatiquement
Doit être mappé

Note : Vous pouvez également saisir les informations dans Catalog, remplaçant les informations stockées et transmises depuis Magento.

En savoir plus sur les informations produit par plateforme.

Réserver une démo

Cette page a-t-elle été utile?

Obtenir de l'aide·Documents juridiques·© 2026 Zonos
Sur cette page :
  • Checkout pour Magento
  • Intégrer
  • Désinstaller Checkout
  • Foire aux questions