Suivez cette liste de contrôle complète pour configurer votre compte Zonos Dashboard et intégrer Zonos Checkout dans votre site ou plateforme personnalisé.
1
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 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.
2
Configurer Dashboard et les paramètres 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 Dashboard essentielles.
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 :
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
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.
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.
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 :
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.
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 :
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 que vous souhaitez proposer.
Pour plus de détails sur les zones d'expédition, consultez notre documentation.
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 :
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.
3
Installer le snippet Zonos JS
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.
1
Passez les ID correspondants via votre customHTML Checkout afin que le relais sache quelle propriété/pixel cibler :
1
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 :
Synchronise votre numéro de compte natif avec Dashboard. Docs →
orderAddTrackingNumber
Requis uniquement si vous n'imprimez pas les étiquettes dans Dashboard. Garantit que le suivi s'affiche dans Dashboard afin que Zonos puisse garantir vos calculs de landed cost. Docs →
Nécessaire pour envoyer les commandes Checkout à votre plateforme native. Docs →
ORDER_STATUS_CHANGED
Maintient votre système synchronisé avec Zonos lorsque les statuts de commande changent (p. ex., fulfilled, canceled). Docs →
7
Tester votre intégration
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.
Questions fréquentes
Voici quelques questions fréquentes sur le processus d'intégration.
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.
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.
1query getCheckoutSession(: String
2checkoutSession )
3order
4id
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.
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.
Intégration personnalisée
Intégration personnalisée
Créez une intégration Checkout de bout en bout dans votre site personnalisé.
Liste de contrôle d'intégration
Suivez cette liste de contrôle complète pour configurer votre compte Zonos Dashboard et intégrer Zonos Checkout dans votre site ou plateforme personnalisé.
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 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.
Configurer Dashboard et les paramètres 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 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 :
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 :
example.com, vous devez ajouterexample.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 :
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 :
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 :
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 :
Installer le snippet Zonos JS
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 :
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.
customHTMLCheckout 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 :Synchroniser le suivi et le statut des commandes dans Dashboard
Pour synchroniser les commandes entre votre système et Zonos Dashboard, implémentez ces appels API et webhooks :
Mutations requises
orderUpdateAccountOrderNumberorderAddTrackingNumberWebhooks requis
ORDER_CREATEDORDER_STATUS_CHANGEDTester votre intégration
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.
Questions fréquentes
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 :
zOrderNumber(etorderIdpour les paniers hérités) ajoutés comme paramètres de requête.zonosCheckoutSessionIdcomme 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
zonosCheckoutSessionIdLorsque 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
zonosCheckoutSessionIddepuis l'URL et interrogez la requête GraphQLcheckoutSessiondepuis 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.query getCheckoutSession(: StringcheckoutSession )orderidEnvoyez la requête à
https://api.zonos.com/graphqlavec votre jeton d'identification secret depuis Dashboard -> Settings -> Integrations passé comme en-tête de requêtecredentialToken.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.
Cette page a-t-elle été utile?