Intégration personnalisée

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 qui devront être vérifiés.

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.

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 Dashboard essentielles.

Configurer les versements 

Connectez un compte bancaire pour recevoir des versements ponctuels de Checkout. Les versements sont traités quotidiennement dans un délai de 2 jours après la capture du paiement. Pour ce faire, suivez ces étapes :

1. Accédez à Dashboard -> Settings -> Checkout settings .
2. Cliquez sur Add bank account
3. Vous serez redirigé vers un portail Stripe pour terminer 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 sur la raison de cette exigence, consultez la documentation de Stripe.

Note : Si vous devez mettre à jour votre calendrier de versements, veuillez contacter support@zonos.com

Configurer les domaines autorisés 

Le script Zonos JS nécessite une liste de domaines autorisés pour des raisons de sécurité. Cela empêche les sites non autorisés de charger le script et garantit qu'il ne s'exécute que sur vos domaines approuvés. Sans cette configuration, le script renverra des erreurs d'autorisation.

Pour configurer cela :

1. Accédez à Dashboard -> Settings -> Checkout settings
2. 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 ajouter example.com et test.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 :

1. Accédez à Dashboard -> Settings -> Checkout settings -> Branding
2. 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 établir un devis d'expédition au paiement, vous devrez connecter 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 :

1. Accédez à Dashboard -> Settings -> Shipping -> Rates
2. Cliquez sur Add carrier
3. 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 d'expédition sont disponibles pour différentes régions du monde.

Pour configurer les zones d'expédition, suivez 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 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 secours 

Le pays d'origine et le code HS sont utilisés pour 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 secours configurées dans Dashboard.

Pour définir votre pays d'origine et code HS de secours :

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.

Le snippet Zonos JS est une intégration JavaScript côté client qui active la fonctionnalité de paiement global sur votre site. Il sert de pont entre votre plateforme e-commerce et les services Zonos, gérant :

• Expérience Checkout : Affiche l'interface de paiement et traite les paiements.
• Services de localisation : Détecte l'emplacement du visiteur et gère la conversion de devise.
• Intégration du panier : Se connecte à votre système de panier et de commande existant.
• Sécurité : Valide les domaines et authentifie les requêtes API.

Le snippet est chargé de manière asynchrone pour éviter tout impact sur les performances de votre site. Il s'initialise avec les identifiants API de votre boutique et gère toutes les interactions côté client de manière sécurisée. L'implémentation est conçue pour être non intrusive, nécessitant des modifications minimales de votre flux de paiement existant.

Ci-dessous se trouve un exemple complet incluant le chargement du script, l'initialisation et la gestion des événements à utiliser comme référence lors de l'intégration de Checkout.

4. Passez les ID correspondants via votre customHTML Checkout afin que le relais sache quelle propriété/pixel cibler :

Pour des instructions iframe étape par étape, la référence complète des événements (y compris le mappage de charge utile purchase / Purchase) et des conseils de débogage, consultez :

• Google Analytics 4 pour iframe Checkout
• Facebook Pixel pour iframe Checkout

Pour synchroniser les commandes entre votre système et Zonos Dashboard, implémentez ces appels API et webhooks :

Mutations requises 

Webhooks requis 

Avant de passer en production avec votre intégration Checkout, il est important de tester minutieusement tous les aspects de l'intégration pour garantir une expérience client fluide. Cela inclut le test du flux de paiement, du traitement des paiements, de la création de commande et de la fonctionnalité webhook.

Suivez notre guide de test pour vérifier que votre intégration fonctionne correctement et identifier et corriger tout problème avant le lancement en production.

Voici quelques questions fréquentes sur le processus d'intégration.

Comment Zonos gère-t-il la confirmation de commande ? 

Configurez l'expérience post-achat dans Dashboard -> Settings -> Checkout settings sous Success page type. Trois options sont disponibles :

• Show Zonos success page (par défaut, recommandé) — Zonos affiche une page de remerciement intégrée après la commande. La page est toujours affichée, même si la commande échoue à l'importation dans votre système, afin que l'acheteur obtienne toujours une confirmation.
• Redirect to a success page — Zonos attend sur un bref écran « Order complete » jusqu'à la création de la commande, puis redirige vers votre URL de succès configurée avec zOrderNumber (et orderId pour les paniers hérités) ajoutés comme paramètres de requête.
• Close the checkout modal — Zonos ferme sa modale une fois le paiement capturé. Si vous configurez également une URL de succès, Zonos redirige vers cette URL immédiatement après que Stripe collecte le paiement — sans attendre la création de la commande — et ajoute zonosCheckoutSessionId comme paramètre de requête. Utilisez cette option lorsque vous souhaitez le transfert le plus rapide vers votre propre page de succès.

Rechercher la commande à partir de zonosCheckoutSessionId 

Lorsque vous utilisez Close the checkout modal avec une URL de redirection, la commande peut prendre quelques secondes à s'attacher à la session de paiement après la redirection. Lisez zonosCheckoutSessionId depuis l'URL et interrogez la requête GraphQL checkoutSession depuis votre serveur à l'aide de votre jeton d'identification secret jusqu'à ce que la commande soit prête. N'appelez jamais ceci depuis le navigateur — le jeton d'identification secret doit rester côté serveur.

Envoyez la requête à https://api.zonos.com/graphql avec votre jeton d'identification secret depuis Dashboard -> Settings -> Integrations passé comme en-tête de requête credentialToken.

Puis-je être notifié lorsqu'une commande est créée ? 

Oui. Si vous souhaitez recevoir des notifications lorsqu'une commande est créée, dans Dashboard sous la section Email des Checkout settings, vous pouvez saisir l'adresse e-mail des membres de l'équipe à notifier lorsqu'une commande est créée, expédiée ou annulée.