Liste de vérification d'intégration
Suivez cette liste de vérification complète pour configurer votre compte Zonos Dashboard et intégrer l'extension Zonos Checkout pour WooCommerce.
Créer un compte Zonos
Pour commencer, veuillez contacter notre équipe de vente pour créer un compte et signer un accord. Une fois l'accord signé, vous recevrez deux micro-dépôts dans votre compte qui doivent être vérifiés.
Veuillez envoyer ces montants de micro-dépôts à accounting@zonos.com avec votre ID de boutique Dashboard (CC votre représentant commercial).
Une fois vérifié, vos coordonnées bancaires s'afficheront dans Dashboard -> Settings -> Billing.
Configurer les paramètres de Dashboard et de Checkout
Après avoir créé votre compte Zonos, vous devrez configurer les paramètres dans Dashboard pour garantir que Checkout fonctionne correctement avec votre boutique. Cette section couvre toutes les configurations essentielles de Dashboard.
Configurer les paiements
Connectez un compte bancaire pour recevoir des paiements en temps voulu de Checkout. Les paiements sont traités quotidiennement avec un délai de 2 jours à partir du paiement capturé. Pour ce faire, veuillez suivre ces étapes :
- Accédez à Dashboard -> Settings -> Checkout settings .
- Cliquez sur Ajouter un compte bancaire.
- Vous serez redirigé vers un portail Stripe pour compléter la configuration et fournir les informations suivantes :
- Informations sur le compte bancaire.
- EIN de l'entreprise.
- Numéro de sécurité sociale d'un propriétaire d'entreprise à 25 %. Pour plus de détails sur pourquoi cela est requis, consultez la documentation de Stripe.
Remarque : Si vous devez mettre à jour votre calendrier de paiements, veuillez contacter support@zonos.com
Configurer les domaines autorisés
Zonos Checkout nécessite 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 fonctionne que sur vos domaines approuvés. Sans cette configuration, Checkout renverra des erreurs de permission.
Pour configurer cela :
- Accédez à Dashboard -> Settings -> Checkout settings.
- Sous URLs, ajoutez votre domaine complet et tous les sous-domaines où Checkout sera utilisé. Par exemple, si votre domaine est
example.com
, vous devez ajouterexample.com
ettest.example.com
.
Personnaliser les paramètres de marque
Configurez vos paramètres de marque dans Dashboard pour correspondre à l'apparence et à la convivialité de votre boutique.
Pour ce faire, veuillez suivre ces étapes :
- Accédez à Dashboard -> Settings -> Checkout settings -> Branding
- Configurez les paramètres suivants :
- Logo.
- Couleur de marque et couleur d'accent.
- Thème, style et police.
Pour plus d'informations sur les paramètres de marque, consultez notre documentation.
Connecter un transporteur
Pour estimer les frais d'expédition à checkout, vous devrez connecter un transporteur à votre compte Zonos. Cela vous permettra d'activer des niveaux de service d'expédition spécifiques à checkout.
Pour connecter un transporteur, veuillez suivre ces étapes :
- Accédez à Dashboard -> Settings -> Shipping -> Rates.
- Cliquez sur Ajouter un transporteur.
- Suivez les instructions de configuration du transporteur.
Pour plus de détails sur la connexion des comptes de transporteur, consultez notre documentation.
Configurer des zones d'expédition
Les zones d'expédition vous permettent de configurer quels transporteurs et niveaux de service d'expédition sont disponibles pour différentes régions du monde.
Pour configurer des zones d'expédition, veuillez suivre ces étapes :
- Accédez à Dashboard -> Settings -> Shipping -> Locations.
- Cliquez sur Nouvelle zone.
- Entrez un nom de zone et sélectionnez les pays vers lesquels vous souhaitez expédier.
- Sélectionnez le transporteur et le niveau de service que vous souhaitez offrir.
Pour plus de détails sur les zones d'expédition, consultez notre documentation.
Configurer un pays d'origine de secours et un code HS
Le pays d'origine et le code HS sont utilisés pour calculer les droits et taxes exacts.
Si vous ne fournissez pas de pays d'origine spécifique ou de code HS, nous utiliserons les valeurs de secours configurées dans Dashboard.
Pour définir votre pays d'origine de secours et votre code HS :
- 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, entrez le code HS de votre produit le plus courant. Si vous n'avez pas de code HS, accédez à Classify dans Dashboard et entrez 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 administration WordPress.
- Sous plugins, recherchez l'extension Zonos Checkout pour WooCommerce.
- Cliquez sur Installer et activer.
Connecter l'extension à votre compte Zonos
-
Dans votre administration WordPress, cliquez sur l'extension Zonos Checkout dans la navigation à gauche.
-
Cliquez sur Paramètres généraux.
-
Entrez votre Clé API privée et ID de magasin pour lier les paramètres de votre tableau de bord Zonos à votre site WooCommerce.
-
Localisez la clé API privée de votre magasin dans Dashboard. Il existe plusieurs clés API disponibles. Sélectionnez la clé API qui porte le nom de votre magasin, le Type est Secret, et le Token commence par
credential_live
. Saisissez cette clé API dans le champ Clé API privée dans les Paramètres généraux de l'extension. -
Copiez votre ID de magasin depuis Dashboard et saisissez-le dans le champ ID de magasin dans les Paramètres généraux de l'extension.
-
-
Activez l'application en mode test.
- Par défaut, le Mode test est activé. Lorsque le mode test est activé, les acheteurs ne seront pas dirigés vers Zonos Checkout.
Configurer votre bouton checkout international
Vous avez deux options pour configurer comment les acheteurs internationaux accèdent à Zonos Checkout.
Utiliser votre bouton checkout actuel pour les acheteurs nationaux et internationaux :
Configurez votre bouton checkout actuel pour rediriger automatiquement les acheteurs internationaux vers Zonos Checkout tout en gardant les acheteurs nationaux sur votre flux standard de checkout. Pour ce faire, suivez ces étapes :
- Dans les Paramètres généraux de l'extension, entrez le sélecteur CSS de votre bouton checkout (par exemple,
#checkout-button
ou.woocommerce-checkout-button
). - Cliquez sur Enregistrer les paramètres généraux.
Pour trouver votre sélecteur CSS, faites un clic droit sur votre bouton checkout, sélectionnez "Inspecter", et recherchez l'attribut id
ou class
dans le HTML. Si vous avez plusieurs boutons checkout, incluez le sélecteur CSS de chaque bouton ou configurez tous les boutons pour rediriger vers la page du panier et utilisez le sélecteur du bouton checkout de la page du panier.
Ajouter un bouton checkout international dédié
Créez un bouton checkout international dédié, ce qui est idéal si vous avez de nombreux utilisateurs de VPN ou des acheteurs basés aux États-Unis qui doivent expédier à une adresse internationale.
Pour créer un bouton séparé pour les acheteurs internationaux :
-
Dans les Paramètres généraux de l'extension, entrez le sélecteur CSS de votre bouton checkout (par exemple,
#checkout-button
ou.woocommerce-checkout-button
). -
Activez le Bouton checkout international à droite.
-
Configurez l'apparence du bouton :
- Entrez le texte du bouton (par exemple, "International Checkout" ou "Global Checkout").
- (Optionnel) Ajoutez du CSS personnalisé pour correspondre au design de votre magasin comme indiqué dans l'exemple ci-dessous. Si aucun CSS personnalisé n'est fourni, le bouton utilisera par défaut le schéma de couleurs principal de votre magasin. Nous vous recommandons de tester l'apparence du bouton sur les appareils de bureau et mobiles.
-
Cliquez sur Enregistrer les paramètres généraux.
Activer les États-Unis dans les zones d'expédition : Lorsqu'il est activé, le bouton checkout international dédié apparaîtra pour tous les acheteurs. Pour permettre aux acheteurs basés aux États-Unis d'utiliser le checkout international (par exemple, lors de l'utilisation d'un VPN ou d'expédition à une adresse internationale), vous devez activer les États-Unis dans Zones d'expédition dans le 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 s'intégrer parfaitement à votre boutique WooCommerce, garantissant des calculs précis des droits, des taxes et des frais d'expédition. Utilisez l'onglet Paramètres de mappage pour aligner les détails et attributs des produits avec votre configuration e-commerce. Bien que des valeurs par défaut soient fournies, vous pouvez configurer ces paramètres pour répondre aux exigences uniques de votre magasin.
Détails des 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 vous utilisez une application tierce qui remplace des champs (*), assurez-vous que ces champs (*) sont correctement mappés aux valeurs utilisées par l'application tierce.
Attributs des 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 lorsque la commande est exécutée, votre boutique WooCommerce et votre inventaire sont mis à jour avec le bon produit qui a été expédié. Pour mapper les attributs, suivez les étapes décrites dans notre documentation de mappage des attributs de produit WooCommerce.
Remarque : Si vous avez des questions ou avez besoin d'aide pour mapper les variations de produit, veuillez contacter support@zonos.com.
Testez votre intégration
Maintenant que vous avez configuré votre compte et votre application, vous êtes prêt à tester votre intégration.
Pour passer une commande de test à checkout :
- Ajoutez
?zonosTestMode=1
à l'URL de votre boutique pour être dirigé vers Zonos Checkout. - Changez Zonos Hello pour le pays que vous souhaitez tester en cliquant sur le drapeau Hello et en sélectionnant le pays que vous souhaitez tester. Cela est nécessaire sinon vous ne serez pas redirigé vers Zonos Checkout si vous utilisez un seul bouton checkout. Vous pouvez mettre à jour Hello en changeant zCountry= dans l'URL par le pays que vous souhaitez tester. Par exemple, si vous souhaitez tester le Canada, vous devez entrer CA dans zCountry=CA.
- Parcourez le processus checkout et passez une commande. Consultez notre documentation générale de test pour plus de détails.
- Après avoir terminé les tests, activez Zonos en basculant Test mode sur off. Cela mettra votre intégration en direct et permettra aux acheteurs internationaux d'utiliser Zonos Checkout.
Quelques points à retenir :
- De minimis—Si le sous-total de votre commande est inférieur au seuil de de minimis du pays de destination, il se peut qu'aucun droit ou taxe ne soit dû. Cela est reflété dans nos calculs.
- Remboursements et annulations—Nous collectons le paiement, donc si vous devez effectuer des remboursements ou des annulations, veuillez les traiter dans le Dashboard.
- Étiquettes—Imprimez des étiquettes pour toutes les commandes internationales dans le Dashboard, sauf si vous avez été certifié pour imprimer des étiquettes en dehors du Dashboard. Cela est requis afin que Zonos puisse payer les droits et taxes en votre nom.
Post-intégration
Votre extension Zonos importera automatiquement les commandes de Zonos vers WooCommerce. Cependant, il peut y avoir des cas rares où une commande peut ne pas être importée ou où le statut d'une commande dans WooCommerce n'est pas synchronisé avec le Dashboard. Vous pouvez utiliser les fonctionnalités suivantes dans l'extension pour importer des commandes, synchroniser manuellement les statuts de commande et activer des paramètres avancés pour résoudre les problèmes.
Importer des commandes manuellement
Si une commande Zonos n'a pas été importée dans WooCommerce, vous pouvez utiliser l'onglet Order import pour importer manuellement des commandes dans WooCommerce :
- Connectez-vous à Dashboard.
- Accédez à Orders.
- Cliquez sur la commande qui doit être importée et copiez le Zonos order number.
- Dans l'administration WordPress, accédez à l'onglet Order import dans l'extension Zonos, et entrez le numéro de commande Zonos dans le champ Zonos order number.
- Cliquez sur Import order. Si la commande a été importée avec succès, la commande apparaîtra dans WooCommerce et vous verrez une bannière "Order imported successfully" en haut de la page. Si l'importation de la commande a échoué, vous verrez une bannière avec les détails du message d'erreur.
Synchroniser les commandes manuellement
Si le statut d'une commande dans WooCommerce ne correspond pas au statut dans Zonos, vous pouvez synchroniser manuellement la commande.
- Connectez-vous à Dashboard.
- Accédez à Orders.
- Cliquez sur la commande qui doit être importée et copiez le Zonos order number.
- Dans l'administration WordPress, accédez à l'onglet Order sync dans l'extension Zonos, et entrez le numéro de commande Zonos dans le champ Zonos order number.
- Cliquez sur Sync order. Le statut de la commande dans WooCommerce devrait maintenant correspondre au statut de la commande dans le Dashboard.
Paramètres avancés
Mode débogage
Activez le Debug mode pour envoyer des journaux détaillés de Zonos afin de vous aider à diagnostiquer tout problème et à améliorer les performances de votre intégration.
Limite de Rate
Nombre maximum de requêtes webhook autorisées par adresse IP par minute. La valeur par défaut est 30 pour protéger contre les abus potentiels.
Dépannage courant
Si vous utilisez une application de mise en cache comme WP Rockett, vous devrez clear votre cache lorsque vous apportez des modifications à votre extension Zonos.
Questions fréquemment posées
Quelles informations sur le produit devrais-je fournir pour obtenir le devis le plus précis sur les droits, taxes et frais d'expédition ?
Les informations sur le produit peuvent influencer le montant des droits et taxes dus, ainsi que le coût total d'expédition. Plus vous fournissez d'informations sur le produit à Zonos, plus le devis retourné 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 clés suivants sur le produit 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 listes de produits WooCommerce sont automatiquement utilisés par Zonos lorsqu'ils sont mappés. Vous pouvez également ajouter le poids au Catalog dans le Dashboard pour garantir des calculs d'expédition précis.
- Dimensions : Les dimensions sont utilisées pour calculer le poids dimensionnel. Les transporteurs factureront le poids le plus élevé entre le poids physique et le poids dimensionnel. Zonos peut utiliser les dimensions du produit (longueur, largeur et hauteur) définies sur chaque produit dans WooCommerce pour calculer le poids dimensionnel afin de garantir que vous collect le bon montant d'expédition de vos clients. Vous pouvez également ajouter des dimensions au Catalog dans le Dashboard pour garantir des calculs d'expédition précis.
- 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 le 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 le Dashboard.
Zonos Checkout pour WooCommerce
Intégrez l'extension Checkout pour WooCommerce.