Liste de contrôle d'intégration
Suivez cette liste de contrôle complète pour configurer votre compte Dashboard Zonos et intégrer l'extension Zonos Checkout pour WooCommerce.
Créer un compte Zonos
Pour commencer, veuillez contacter notre équipe commerciale pour créer un compte et signer un accord. Une fois l'accord signé, vous recevrez deux micro-dépôts sur votre compte à vérifier.
Veuillez envoyer ces montants de micro-dépôts par e-mail à accounting@zonos.com avec votre Store ID Dashboard (mettez votre représentant commercial en copie).
Une fois vérifiés, vos coordonnées bancaires s'afficheront dans Dashboard -> Settings -> Billing.
Configurer Dashboard et les paramètres Checkout
Après création de votre compte Zonos, configurez les paramètres dans Dashboard pour garantir le bon fonctionnement de Checkout avec votre boutique. Cette section couvre toutes les configurations Dashboard essentielles.
Configurer les paiements
Connectez un compte bancaire pour recevoir des paiements réguliers de Checkout. Les paiements sont traités quotidiennement avec un délai de 2 jours après la capture. Pour ce faire, suivez ces étapes :
- Accédez à Dashboard -> Settings -> Checkout settings .
- Cliquez sur Add bank account.
- Vous serez redirigé vers un portail Stripe pour finaliser la configuration et fournir les informations suivantes :
- Informations du compte bancaire.
- EIN de l'entreprise.
- Numéro de sécurité sociale d'un propriétaire détenant 25 % de l'entreprise. Pour plus de détails, consultez la documentation de Stripe.
Note : Si vous devez modifier votre calendrier de paiements, contactez support@zonos.com
Configurer les domaines autorisés
Zonos Checkout requiert une liste de domaines autorisés pour des raisons de sécurité. Cela empêche les sites non autorisés de charger Checkout et garantit qu'il ne s'exécute que sur vos domaines approuvés. Sans cette configuration, Checkout retournera des erreurs d'autorisation.
Pour configurer cela :
- Accédez à Dashboard -> Settings -> Checkout settings.
- Sous URLs, ajoutez votre domaine complet et les sous-domaines où Checkout sera utilisé. Par exemple, si votre domaine est
example.com, ajoutezexample.comettest.example.com.
Personnaliser les paramètres de marque
Configurez vos paramètres de marque dans Dashboard pour correspondre à l'apparence de votre boutique.
Pour ce faire, suivez ces étapes :
- Accédez à Dashboard -> Settings -> Checkout settings -> Branding
- Configurez les paramètres suivants :
- Logo.
- Couleur de marque et d'accent.
- Theme, Style et Font.
Pour plus d'informations sur les paramètres de marque, consultez notre documentation.
Connecter un transporteur
Pour coter l'expédition au paiement, connectez un transporteur à votre compte Zonos. Cela vous permettra d'activer des niveaux de service d'expédition spécifiques au paiement.
Pour connecter un transporteur, suivez ces étapes :
- Accédez à Dashboard -> Settings -> Shipping -> Rates.
- Cliquez sur Add carrier.
- Suivez les instructions de configuration du transporteur.
Pour plus de détails sur la connexion de comptes transporteurs, consultez notre documentation.
Configurer les zones d'expédition
Les zones d'expédition vous permettent de configurer quels transporteurs et niveaux de service sont disponibles pour différentes régions du monde.
Pour configurer des zones d'expédition, suivez ces étapes :
- Accédez à Dashboard -> Settings -> Shipping -> Locations.
- Cliquez sur New zone.
- Saisissez un nom de zone et sélectionnez les pays vers lesquels vous souhaitez expédier.
- Sélectionnez le transporteur et le niveau de service à proposer.
Pour plus de détails sur les zones d'expédition, consultez notre documentation.
Configurer un pays d'origine et un code HS de repli
Le pays d'origine et le code HS servent à calculer des droits et taxes précis.
Si vous ne fournissez pas de pays d'origine ou de code HS spécifique, nous utiliserons les valeurs de repli configurées dans Dashboard.
Pour définir votre pays d'origine et code HS de repli :
- Accédez à Dashboard -> Settings -> Shipping -> Catalog.
- Pour le pays d'origine, sélectionnez le pays où la majorité de vos produits sont fabriqués.
- Pour le code HS, saisissez le code HS de votre produit le plus courant. Si vous n'avez pas de code HS, accédez à Classify dans Dashboard et saisissez le nom et la description de votre produit pour générer un code HS précis.
Installer et configurer l'extension Checkout pour WooCommerce
Suivez ces étapes pour installer et configurer l'extension Checkout pour WooCommerce.
Installer l'extension
- Connectez-vous à votre admin WordPress.
- Sous plugins, recherchez Zonos Checkout for WooCommerce extension.
- Cliquez sur Install and activate.
Connecter l'extension à votre compte Zonos
-
Dans votre admin WordPress, cliquez sur l'extension Zonos Checkout dans la navigation de gauche.
-
Cliquez sur General Settings.
-
Saisissez votre Private API key et Store ID pour lier vos paramètres Dashboard Zonos à votre site WooCommerce.
-
Localisez la clé API privée de votre boutique dans Dashboard. Plusieurs clés API sont disponibles. Sélectionnez celle portant le nom de votre boutique, avec Type = Secret et Token commençant par
credential_live. Saisissez cette clé dans le champ Private API Key des General settings de l'extension. -
Copiez votre Store ID depuis Dashboard et saisissez-le dans le champ Store ID des General settings de l'extension.
-
-
Activez l'application en mode test.
- Par défaut, Test mode est activé. En mode test, les acheteurs ne seront pas redirigés vers Zonos Checkout.
Configurer votre bouton de paiement international
Vous avez deux options pour configurer l'accès des acheteurs internationaux à Zonos Checkout.
Utiliser votre bouton de paiement actuel pour les acheteurs domestiques et internationaux :
Configurez votre bouton de paiement actuel pour rediriger automatiquement les acheteurs internationaux vers Zonos Checkout tout en conservant les acheteurs domestiques sur votre flux de paiement standard. Pour ce faire, suivez ces étapes :
- Dans les General settings de l'extension, saisissez le sélecteur CSS de votre bouton de paiement (p. ex.
#checkout-buttonou.woocommerce-checkout-button). - Cliquez sur Save general settings.
Pour trouver votre sélecteur CSS, cliquez avec le bouton droit sur votre bouton de paiement, sélectionnez « Inspect », et recherchez l'attribut id ou class dans le HTML. Si vous avez plusieurs boutons de paiement, incluez chaque sélecteur CSS ou configurez tous les boutons pour rediriger vers la page panier.
Ajouter un bouton de paiement international dédié
Créez un bouton de paiement international dédié, idéal si vous avez de nombreux utilisateurs VPN ou des acheteurs basés aux États-Unis devant expédier vers une adresse internationale.
Pour créer un bouton séparé pour les acheteurs internationaux :
-
Dans les General settings de l'extension, saisissez le sélecteur CSS de votre bouton de paiement (p. ex.
#checkout-buttonou.woocommerce-checkout-button). -
Activez International checkout button vers la droite.
-
Configurez l'apparence du bouton :
- Saisissez le texte du bouton (p. ex. « International Checkout » ou « Global Checkout »).
- (Optionnel) Ajoutez du CSS personnalisé pour correspondre au design de votre boutique. Sans CSS personnalisé, le bouton utilisera la palette de couleurs principale de votre boutique. Nous recommandons de tester l'apparence sur ordinateur et mobile.
-
Cliquez sur Save general settings.
Enable US in Shipping zones : Lorsque activé, le bouton de paiement international dédié apparaîtra pour tous les acheteurs. Pour permettre aux acheteurs basés aux États-Unis d'utiliser le paiement international (par exemple via VPN ou expédition vers une adresse internationale), vous devez activer les États-Unis dans Shipping zones dans Dashboard. Sans ce paramètre, les acheteurs américains ne seront pas redirigés vers Zonos Checkout.
Mapper les paramètres WooCommerce
Personnalisez Zonos pour une intégration fluide avec votre boutique WooCommerce, garantissant des calculs précis de droits, taxes et expédition. Utilisez l'onglet Mapping settings pour aligner détails produits et attributs avec votre configuration e-commerce. Des valeurs par défaut sont fournies, mais vous pouvez les adapter aux exigences de votre boutique.
Détails produits, détails personnalisés, poids et dimensions
Ces champs sont mappés à des valeurs communes par défaut. Les valeurs marquées d'un astérisque (*) sont requises. Si une application tierce remplace des champs (*), assurez-vous que ces champs (*) sont correctement mappés aux valeurs utilisées par l'application tierce.
Attributs produits
Si vos produits ont des attributs uniques comme la couleur ou la taille appliqués aux variations, vous devrez mapper ces attributs dans l'extension Zonos. Cela garantit que lors du fulfillment, votre boutique WooCommerce et votre inventaire sont mis à jour avec le produit correct expédié. Pour mapper les attributs, suivez les étapes de notre documentation de mapping des attributs produits WooCommerce.
Note : Si vous avez des questions ou besoin d'aide pour mapper les variations produits, contactez support@zonos.com.
Tester votre intégration
Maintenant que votre compte et votre application sont configurés, vous êtes prêt à tester votre intégration.
Pour passer une commande test au paiement :
- Ajoutez
?zonosTestMode=1à l'URL de votre boutique pour être redirigé vers Zonos Checkout. - Changez Zonos Hello vers le pays que vous souhaitez tester en cliquant sur le drapeau Hello et en sélectionnant le pays. C'est nécessaire sinon vous ne serez pas redirigé vers Zonos Checkout avec un seul bouton de paiement. Vous pouvez mettre à jour Hello en modifiant zCountry= dans l'URL. Par exemple, pour tester le Canada, saisissez CA dans zCountry=CA.
- Parcourez le processus de paiement et passez une commande. Consultez notre documentation de test générale pour plus de détails.
- Après les tests, activez Zonos en désactivant Test mode. Cela mettra votre intégration en production et permettra aux acheteurs internationaux d'utiliser Zonos Checkout.
Quelques points à retenir :
- De minimis — Si le sous-total du panier est inférieur au de minimis du pays de destination, aucun droit ni taxe ne sera peut-être dû. Cela se reflète dans nos calculs.
- Remboursements et annulations — Nous collectons le paiement, donc pour tout remboursement ou annulation, traitez-les dans Dashboard.
- Étiquettes — Imprimez les étiquettes pour toutes les commandes internationales dans Dashboard, sauf si vous êtes certifié pour imprimer hors Dashboard. C'est requis pour que Zonos paie droits et taxes en votre nom.
Après l'intégration
Votre extension Zonos importera automatiquement les commandes de Zonos vers WooCommerce. Cependant, il peut arriver qu'une commande ne s'importe pas ou qu'un statut de commande WooCommerce ne soit pas synchronisé avec Dashboard. Utilisez les fonctionnalités suivantes de l'extension pour importer des commandes, synchroniser manuellement les statuts et activer les paramètres avancés pour le dépannage.
Importer des commandes manuellement
Si une commande Zonos ne s'est pas importée dans WooCommerce, utilisez l'onglet Order import pour importer manuellement les commandes :
- Connectez-vous à Dashboard.
- Accédez à Orders.
- Ouvrez la commande à importer et copiez le Zonos order number.
- Dans WordPress Admin, accédez à l'onglet Order import de l'extension Zonos et saisissez le numéro de commande Zonos dans le champ Zonos order number.
- Cliquez sur Import order. Si l'import a réussi, la commande apparaîtra dans WooCommerce avec la bannière « Order imported successfully ». En cas d'échec, une bannière affichera les détails de l'erreur.
Synchroniser des commandes manuellement
Si un statut de commande WooCommerce ne correspond pas au statut Zonos, vous pouvez synchroniser manuellement la commande.
- Connectez-vous à Dashboard.
- Accédez à Orders.
- Ouvrez la commande à importer et copiez le Zonos order number.
- Dans WordPress Admin, accédez à l'onglet Order sync de l'extension Zonos et saisissez le numéro de commande Zonos.
- Cliquez sur Sync order. Le statut WooCommerce devrait maintenant correspondre au statut Dashboard.
Paramètres avancés
Mode debug
Activez Debug mode pour envoyer à Zonos des journaux détaillés afin de diagnostiquer les problèmes et améliorer les performances de votre intégration.
Limite de débit
Nombre maximum de requêtes webhook autorisées par adresse IP et par minute. La valeur par défaut est 30 pour protéger contre les abus.
Dépannage courant
Si vous utilisez une application de cache comme WP Rockett, videz votre cache lors de modifications de votre extension Zonos.
Foire aux questions
Quelles informations produits fournir pour le devis le plus précis sur droits, taxes et coûts d'expédition ?
Les informations produits impactent le montant des droits et taxes dus et le coût total d'expédition. Plus vous fournissez d'informations à Zonos, plus le devis sera précis. Zonos peut générer un devis même sans ces informations, mais recommande de fournir les détails produits clés suivants pour améliorer la précision :
- Poids : Le poids impacte votre coût d'expédition, ce qui peut affecter droits ou taxes. Les poids de vos fiches produits WooCommerce sont automatiquement utilisés par Zonos lorsqu'ils sont mappés. Vous pouvez aussi ajouter le poids à Catalog dans Dashboard.
- Dimensions : Les dimensions servent à calculer le poids volumétrique. Les transporteurs facturent le plus élevé entre poids physique et poids volumétrique. Zonos peut utiliser les dimensions (longueur, largeur, hauteur) définies sur chaque produit WooCommerce. Vous pouvez aussi ajouter les dimensions à Catalog dans Dashboard.
- Codes HS : Les codes HS impactent les taux de droits et peuvent parfois affecter les taxes. Vous pouvez mapper les valeurs de code HS dans WooCommerce ou utiliser Catalog dans Dashboard.
- Pays d'origine : Le pays d'origine d'un produit impacte les taux de droits et peut affecter les taxes. Vous pouvez mapper les valeurs de pays d'origine dans WooCommerce ou utiliser Catalog dans Dashboard.
Zonos Checkout for WooCommerce
Intégrez l'extension Checkout pour WooCommerce.