Zonos Checkout pour WooCommerce

Pour commencer, veuillez communiquer avec notre équipe des ventes afin de créer un compte et de signer une entente. Une fois l'entente signée, vous recevrez deux microdépôts dans votre compte, qui devront être vérifiés.

Veuillez envoyer le montant de ces microdépôts par courriel à accounting@zonos.com avec l'identifiant de votre boutique Dashboard (en mettant votre représentant des ventes en copie conforme).

Une fois la vérification effectuée, vos coordonnées bancaires s'afficheront dans Dashboard -> Settings -> Billing.

Après avoir créé votre compte Zonos, vous devrez configurer certains paramètres dans Dashboard pour que Checkout fonctionne correctement avec votre boutique. Cette section couvre toutes les configurations essentielles de Dashboard.

Configurer les versements 

Associez un compte bancaire pour recevoir vos versements de Checkout en temps voulu. Les versements sont traités quotidiennement, avec un délai de 2 jours suivant la saisie du paiement. Pour ce faire, veuillez suivre ces étapes :

1. Accédez à Dashboard -> Settings -> Checkout settings .
2. Cliquez sur Add bank account.
3. Vous serez dirigé vers un portail Stripe pour terminer la configuration et fournir les renseignements suivants :
   • Renseignements sur le compte bancaire.
   • EIN de l'entreprise.
   • Numéro de sécurité sociale d'un propriétaire détenant 25 % de l'entreprise. Pour savoir pourquoi ce renseignement est exigé, consultez la documentation de Stripe.

Remarque : Si vous devez modifier votre calendrier de versements, veuillez écrire à support@zonos.com

Configurer les domaines autorisés 

Zonos Checkout exige 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 renverra des erreurs d'autorisation.

Pour configurer cette liste :

1. Accédez à Dashboard -> Settings -> Checkout settings.
2. Sous URLs, ajoutez votre domaine complet ainsi que tous les sous-domaines où Checkout sera utilisé. Par exemple, si votre domaine est example.com, vous devriez ajouter example.com et test.example.com.

Personnaliser les paramètres de l'image de marque 

Configurez les paramètres de l'image de marque dans Dashboard pour qu'ils correspondent à l'apparence de votre boutique.

Pour ce faire, veuillez suivre ces étapes :

1. Accédez à Dashboard -> Settings -> Checkout settings -> Branding
2. Configurez les paramètres suivants :
   • Logo.
   • Couleur de la marque et couleur d'accent.
   • Thème, style et police.

Pour en savoir plus sur les paramètres de l'image de marque, consultez notre documentation.

Associer un transporteur 

Pour fournir une soumission des frais d'expédition au moment du paiement, vous devrez associer un transporteur à votre compte Zonos. Vous pourrez ainsi activer des niveaux de service d'expédition précis au moment du paiement.

Pour associer un transporteur, veuillez suivre ces étapes :

1. Accédez à Dashboard -> Settings -> Shipping -> Rates.
2. Cliquez sur Add carrier.
3. Suivez les instructions de configuration du transporteur.

Pour en savoir plus sur l'association de comptes de transporteurs, consultez notre documentation.

Configurer les zones d'expédition 

Les zones d'expédition vous permettent de configurer les transporteurs et les niveaux de service offerts dans les différentes régions du monde.

Pour configurer les zones d'expédition, veuillez suivre ces étapes :

1. Accédez à Dashboard -> Settings -> Shipping -> Locations.
2. Cliquez sur New zone.
3. Saisissez un nom de zone et sélectionnez les pays vers lesquels vous souhaitez expédier.
4. Sélectionnez le transporteur et le niveau de service que vous souhaitez offrir.

Pour en savoir plus sur les zones d'expédition, consultez notre documentation.

Configurer un pays d'origine et un code HS par défaut 

Le pays d'origine et le code HS servent à calculer avec précision les droits et les taxes.

Si vous ne fournissez pas de pays d'origine ou de code HS précis, nous utiliserons les valeurs par défaut configurées dans Dashboard.

Pour définir votre pays d'origine et votre code HS par défaut :

1. Accédez à Dashboard -> Settings -> Shipping -> Catalog.
2. Pour le pays d'origine, sélectionnez le pays où la majorité de vos produits sont fabriqués.
3. 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.

Suivez ces étapes pour installer et configurer l'extension Checkout pour WooCommerce.

Installer l'extension 

1. Connectez-vous à l'administration de WordPress.
2. Dans les extensions, recherchez l'extension Zonos Checkout for WooCommerce.
3. Cliquez sur Install and activate.

Associer l'extension à votre compte Zonos 

1. Dans l'administration de WordPress, cliquez sur l'extension Zonos Checkout dans le menu de navigation de gauche.

2. Cliquez sur General Settings.

3. Saisissez votre Private API key et votre Store ID pour lier les paramètres de votre Zonos Dashboard à votre site WooCommerce.

   1. Repérez la clé d'API privée de votre boutique dans Dashboard. Plusieurs clés d'API sont disponibles. Sélectionnez la clé d'API qui porte le nom de votre boutique, dont le Type est Secret et dont le Token commence par credential_live. Saisissez cette clé d'API dans le champ Private API Key des General settings de l'extension.

   2. Copiez votre Store ID depuis Dashboard et saisissez-le dans le champ Store ID des General settings de l'extension.

4. Activez l'application en mode test.

   1. Par défaut, l'option Test mode est activée. Lorsque le mode test est activé, les acheteurs ne sont pas dirigés vers Zonos Checkout.

Configurer votre bouton de paiement international 

Deux options s'offrent à vous pour configurer la façon dont les acheteurs internationaux accèdent à Zonos Checkout.

Utiliser votre bouton de paiement actuel pour les acheteurs nationaux et internationaux : 

Configurez votre bouton de paiement actuel pour qu'il redirige automatiquement les acheteurs internationaux vers Zonos Checkout, tout en conservant le processus de paiement standard pour les acheteurs nationaux. Pour ce faire, suivez ces étapes :

1. Dans les General settings de l'extension, saisissez le sélecteur CSS de votre bouton de paiement (p. ex., #checkout-button ou .woocommerce-checkout-button).
2. Cliquez sur Save general settings.

Pour trouver votre sélecteur CSS, cliquez avec le bouton droit de la souris sur votre bouton de paiement, sélectionnez « Inspect », puis repérez l'attribut id ou class dans le code HTML. Si vous avez plusieurs boutons de paiement, incluez le sélecteur CSS de chacun d'eux ou configurez tous les boutons pour qu'ils redirigent vers la page du panier, puis utilisez le sélecteur du bouton de paiement de la page du panier.

Ajouter un bouton de paiement international dédié 

Créez un bouton de paiement international dédié, une solution idéale si vous avez de nombreux utilisateurs de RPV ou des acheteurs situés aux États-Unis qui doivent expédier vers une adresse internationale.

Pour créer un bouton distinct pour les acheteurs internationaux :

1. Dans les General settings de l'extension, saisissez le sélecteur CSS de votre bouton de paiement (p. ex., #checkout-button ou .woocommerce-checkout-button).

2. Faites glisser l'interrupteur International checkout button vers la droite.

3. Configurez l'apparence du bouton :

   • Saisissez le texte du bouton (p. ex., « International Checkout » ou « Global Checkout »).
   • (Facultatif) Ajoutez du CSS personnalisé pour l'harmoniser avec le design de votre boutique, comme dans l'exemple ci-dessous. Si aucun CSS personnalisé n'est fourni, le bouton utilisera par défaut la palette de couleurs principale de votre boutique. Nous vous recommandons de vérifier l'apparence du bouton sur ordinateur et sur appareil mobile.

4. Cliquez sur Save general settings.

Activer les États-Unis dans les zones d'expédition : Lorsque cette option est activée, le bouton de paiement international dédié s'affiche pour tous les acheteurs. Pour permettre aux acheteurs situés aux États-Unis d'utiliser le paiement international (par exemple, lorsqu'ils utilisent un RPV ou expédient vers une adresse internationale), vous devez activer les États-Unis dans les Shipping zones de Dashboard. Sans ce paramètre, les acheteurs situés aux États-Unis ne seront pas redirigés vers Zonos Checkout.

Personnalisez Zonos pour l'intégrer harmonieusement à votre boutique WooCommerce et obtenir des calculs précis des droits, des taxes et des frais d'expédition. Utilisez l'onglet Mapping settings pour faire correspondre les détails et les attributs des produits à la configuration de votre commerce électronique. Des valeurs par défaut sont fournies, mais vous pouvez configurer ces paramètres selon les besoins propres à votre boutique.

Détails des produits, détails douaniers, poids et dimensions 

Ces champs sont associés à des valeurs courantes par défaut. Les valeurs marquées d'un astérisque (*) sont obligatoires. Si vous utilisez une application tierce qui remplace l'un des champs (*), assurez-vous que ces champs (*) sont correctement associés aux valeurs utilisées par l'application tierce.

Attributs des produits 

Si vos produits comportent des attributs uniques, comme la couleur ou la taille, appliqués à des variantes, vous devrez associer ces attributs dans l'extension Zonos. Ainsi, lorsqu'une commande est traitée, votre boutique WooCommerce et votre inventaire sont mis à jour avec le bon produit expédié. Pour associer les attributs, suivez les étapes décrites dans notre documentation sur l'association des attributs de produits WooCommerce.

Remarque : Si vous avez des questions ou avez besoin d'aide pour associer les variantes de produits, veuillez écrire à support@zonos.com.

Maintenant que votre compte et votre application sont configurés, vous êtes prêt à tester votre intégration.

Pour passer une commande test au moment du paiement :

1. Ajoutez ?zonosTestMode=1 à l'URL de votre boutique pour être dirigé vers Zonos Checkout.
2. Dans Zonos Hello, choisissez le pays que vous souhaitez tester en cliquant sur le drapeau Hello et en sélectionnant ce pays. Cette étape est nécessaire, sinon vous ne serez pas redirigé vers Zonos Checkout si vous utilisez un seul bouton de paiement. Vous pouvez aussi modifier Hello en remplaçant la valeur de zCountry= dans l'URL par le pays que vous souhaitez tester. Par exemple, pour tester le Canada, saisissez CA dans zCountry=CA.
3. Suivez le processus de paiement et passez une commande. Consultez notre documentation générale sur les tests pour en savoir plus.
4. Une fois les tests terminés, activez Zonos en désactivant l'option Test mode. Votre intégration sera alors en ligne et les acheteurs internationaux pourront utiliser Zonos Checkout.

Quelques points à retenir :

• De minimis — Si le sous-total du panier de votre commande est inférieur au seuil de minimis du pays de destination, il est possible qu'aucuns droits ni taxes ne soient exigibles. Nos calculs en tiennent compte.
• Remboursements et annulations — Comme c'est nous qui percevons le paiement, vous devez traiter tout remboursement ou toute annulation dans Dashboard.
• Étiquettes — Imprimez les étiquettes de toutes les commandes internationales dans Dashboard, à moins d'avoir été certifié pour imprimer des étiquettes à l'extérieur de Dashboard. Cette exigence permet à Zonos de payer les droits et les taxes en votre nom.

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 :

1. Connectez-vous à Dashboard.
2. Accédez à Orders.
3. Cliquez sur la commande à importer et copiez le Zonos order number.
4. Dans l'administration de WordPress, accédez à l'onglet Order import de l'extension Zonos, puis saisissez le numéro de commande Zonos dans le champ Zonos order number.
5. Cliquez sur Import order. Si la commande a bien été importée, elle s'affichera dans WooCommerce et une bannière « Order imported successfully » apparaîtra en haut de la page. Si l'importation de la commande a échoué, une bannière affichera les détails du message d'erreur.

Si le statut d'une commande dans WooCommerce ne correspond pas à son statut dans Zonos, vous pouvez synchroniser la commande manuellement.

1. Connectez-vous à Dashboard.
2. Accédez à Orders.
3. Cliquez sur la commande à importer et copiez le Zonos order number.
4. Dans l'administration de WordPress, accédez à l'onglet Order sync de l'extension Zonos, puis saisissez le numéro de commande Zonos dans le champ Zonos order number.
5. Cliquez sur Sync order. Le statut de la commande dans WooCommerce devrait maintenant correspondre au statut de la commande dans Dashboard.

Mode débogage 

Activez l'option Debug mode pour envoyer à Zonos des journaux détaillés qui vous aideront à diagnostiquer les problèmes et à améliorer la performance de votre intégration.

Limite de requêtes 

Nombre maximal de requêtes de webhook autorisées par adresse IP et par minute. La valeur par défaut est de 30, afin de protéger contre les abus potentiels.

Si vous utilisez une application de mise en cache comme WP Rockett, vous devrez vider votre cache chaque fois que vous modifiez votre extension Zonos.

Quels renseignements sur les produits dois-je fournir pour obtenir la soumission la plus précise des droits, des taxes et des frais d'expédition? 

Les renseignements sur les produits peuvent influer sur le montant des droits et des taxes exigibles ainsi que sur le coût total de l'expédition. Plus vous fournissez de renseignements sur les produits à Zonos, plus la soumission obtenue sera précise. Zonos peut générer une soumission même lorsque ces renseignements ne sont pas disponibles, mais recommande de fournir les détails clés suivants sur les produits pour améliorer la précision :

• Poids : Le poids influe sur vos frais d'expédition, ce qui peut avoir une incidence sur les droits ou les taxes. Les poids indiqués dans vos fiches de produits WooCommerce sont automatiquement utilisés par Zonos lorsqu'ils sont associés. Vous pouvez également ajouter le poids dans Catalog dans Dashboard pour garantir des calculs d'expédition précis.
• Dimensions : Les dimensions servent à calculer le poids volumétrique. Les transporteurs facturent selon le plus élevé du poids réel et du poids volumétrique. Zonos peut utiliser les dimensions des produits (longueur, largeur et hauteur) définies pour chaque produit dans WooCommerce afin de calculer le poids volumétrique et de vous assurer de percevoir le bon montant de frais d'expédition auprès de vos clients. Vous pouvez également ajouter les dimensions dans Catalog dans Dashboard pour garantir des calculs d'expédition précis.
• Codes HS : Les codes HS influent sur les taux de droits et peuvent parfois avoir une incidence sur les taxes. Vous pouvez associer les valeurs de code HS dans WooCommerce ou utiliser Catalog dans Dashboard.
• Pays d'origine : Le pays d'origine d'un produit influe sur les taux de droits et peut avoir une incidence sur les taxes. Vous pouvez associer les valeurs de pays d'origine dans WooCommerce ou utiliser Catalog dans Dashboard.