Intégration EasyPost

Guide Intégration EasyPost e-Vend 📮 Guide — Intégration EasyPost Le deuxième transporteur disponible sur e-Vend — même modèle que Shippo, votre propre compte, vos propres tarifs, un seul actif à la fois 🏪 Vendeurs 📦 Expédition Septembre 2026 — v1.1 📖 C'est quoi ? 🆕 Créer un compte ⚙️ Configurer le compte 🔌 Type d'intégration 🔑 Obtenir votre clé API 🔗 Lier à e-Vend 📡 Suivi automatique 🔧 Dépannage ⚖️ Différences avec Shippo 💡 Conseils ⚠️ Ce guide est fourni à titre informatif. Pour toute question, contactez l'équipe e-Vend via la messagerie de votre tableau de bord. 📖 C'est quoi EasyPost ? Le deuxième choix de transporteur sur e-Vend EasyPost fonctionne exactement sur le même principe que Shippo (si vous avez déjà lu ce guide, l'essentiel est identique) : un service qui compare les tarifs de plusieurs transporteurs réels (Canada Post, UPS, FedEx...) et permet d'acheter une étiquette directement depuis e-Vend. 🔑 Un seul transporteur actif à la fois Un vendeur peut activer Shippo OU EasyPost OU Postes Canada direct — jamais deux en même temps. Le bouton "🏷️ Créer une étiquette" sur vos commandes fonctionne exactement pareil peu importe lequel est actif — vous n'avez rien à réapprendre en changeant de transporteur. 🗺️ Le parcours en un coup d'œil 1 Créer un compte EasyPost (gratuit) Avec une adresse courriel professionnelle — voir l'avertissement important plus bas. 2 Compléter la configuration du compte Infos d'entreprise, préférences d'expédition, méthode de paiement (obligatoire même en test). 3 Choisir "API Integration" Pas "Shopify Integration" — ce n'est pas notre cas. 4 Récupérer votre clé API de test Account Settings → API Keys. 5 Coller la clé dans e-Vend Configuration générale — désactive Shippo automatiquement s'il était actif. 6 Créer votre première étiquette Même bouton, même modal que Shippo — rien à changer côté commande. 🆕 Créer un compte EasyPost Gratuit — mais un point critique à respecter dès le départ 🚫 N'utilisez JAMAIS une adresse courriel personnelle (Hotmail, Gmail, Yahoo...) EasyPost refuse carrément certains domaines de courriel grand public à l'inscription — hotmail.com est confirmé bloqué (testé et confirmé par leur support). L'erreur affichée est complètement inutile : un message générique "Something went wrong" qui ne dit jamais pourquoi. Utilisez toujours une adresse de domaine professionnel — la vôtre ( contact@votreboutique.com ) ou celle de votre entreprise. Ça évite des heures de dépannage inutile. 📍 Le formulaire d'inscription easypost.com → Sign up free app.easypost.com/signup Get started in minutes First & last name Jean Tremblay Email address contact@votreboutique.ca Password ●●●●●●●●●●●●●●●● ⚠️ Le mot de passe doit faire au moins 15 caractères — bien plus long que la plupart des sites. Confirm password ●●●●●●●●●●●●●●●● ✓ I agree to the EasyPost Terms of Service and Privacy Policy ✅ Astuce reCAPTCHA Cochez "I'm not a robot" JUSTE avant de cliquer sur "Sign up free" — si vous remplissez le reste du formulaire trop lentement, la vérification expire et il faut recommencer. Sign up free ✉️ Vérification de l'adresse courriel Après l'inscription, une page "Verify your email" apparaît — un code ou un lien de vérification est envoyé à l'adresse fournie. app.easypost.com/verification Verify your email You should receive an email with a verification link shortly. Enter your code   Verify 📭 Vérifiez le dossier Pourriels L'email de vérification peut prendre quelques minutes, et finit parfois dans les pourriels — surtout pour une adresse qui vient d'être créée et n'a pas encore de réputation établie comme expéditeur/destinataire de confiance. ⚙️ Configuration du compte 3 étapes après la vérification — plus complet que Shippo à cette étape 📍 Étape 1 sur 3 — Account Setup Informations d'entreprise et adresse de facturation par défaut. app.easypost.com/account/setup Account Setup — Business Details Business Name e-Vend Phone Number   Predicted Shipping Volume 1–50 shipments/month ▾ Business Address — Will be used as your default address Street Address   City   State   Zip   Country Canada ▾ Next → 📍 Étape 2 sur 3 — Account Configuration Quatre préférences d'expédition (toutes activées par défaut) et une méthode de paiement obligatoire — contrairement à Shippo, qui laissait tester sans carte. app.easypost.com/account/setup 🚚 Use EasyPost Wallet Carriers? Get 70% discounted rates with our carriers. Free! 📮 Need Help with USPS Shipments? Manual claims process if USPS loses the package. You receive 60% of the claim, EasyPost keeps 40%. 🛡️ Want to Protect Your Shipments? Insure against porch pirates, damage and loss. $1.00 per shipment protects $100 of value. 📲 Want to Send Tracking Updates? Tracking page, texts and email communication. $0.03 per shipment. Subscription Payment Method: * Add Payment Method ✓ I agree to the UPS Technology Agreement and Terms & Conditions ✓ I will not ship any Prohibited Items that UPS disallows Get Started 📋 Que faire des 4 interrupteurs ? Option Recommandation Pourquoi Use EasyPost Wallet Carriers ✅ Garder activé Gratuit — accès aux transporteurs partagés à tarif réduit, équivalent du compte partagé Shippo Need Help with USPS Shipments Indifférent USPS est américain — peu pertinent pour des vendeurs canadiens, mais aucun coût à le laisser activé Want to Protect Your Shipments Optionnel 1$/envoi, seulement si utilisé — aucun risque à laisser activé Want to Send Tracking Updates ✅ Recommandé 0,03$/envoi — pages de suivi et notifications, coût minime 💳 Une carte est exigée même pour tester Le bouton "Get Started" reste grisé tant qu'aucune méthode de paiement n'est ajoutée. Ça ne facture rien tant que vous utilisez votre clé de test — mais gardez un œil sur votre relevé après vos premiers essais, par prudence. 💰 Wallet AutoReload Settings Un dernier écran apparaît pour configurer la recharge automatique du portefeuille (utilisé seulement pour de vraies étiquettes en production) : app.easypost.com/account/setup Wallet AutoReload Settings Amount: $20 ▾ Trigger when balance is below: $0 ▾ Cancel Next Les valeurs par défaut ($20 / seuil $0) sont sécuritaires — cette recharge automatique ne s'active jamais en mode test, seulement pour de vrais achats en production. 🔌 Type d'intégration — étape 3 sur 3 Le choix le plus important de tout le processus app.easypost.com/account/integration-setup Integration Setup 🛍️ Shopify Integration Connect EasyPost Nexus to your Shopify account and pull in order data. ✅ Choisir celui-ci 🔗 API Integration Use EasyPost Suite to access shipping APIs, Luma AI, and Advanced Tracking. ✅ Choisissez toujours "API Integration" "Shopify Integration" (Nexus) synchronise EasyPost directement avec une boutique Shopify externe — ce n'est pas notre cas, e-Vend gère déjà toutes les commandes. "API Integration" (Suite) donne accès aux vraies clés API dont notre système a besoin. 🎨 Un dernier écran optionnel — "Customer Experience" Un dernier modal peut apparaître, proposant de personnaliser le logo/couleurs des pages de suivi que vos clients verraient. Pas nécessaire pour le fonctionnement de base — cliquez sur "I'll do this later" pour passer directement. 🛡️ Un bandeau "Security Verification Required" peut apparaître Après l'inscription, un bandeau jaune peut indiquer que le compte "may be limited from accessing certain features". Dans nos tests, ça n'a pas empêché d'obtenir des tarifs ni d'acheter une étiquette — probablement une vérification standard pour un compte tout neuf. Si vous rencontrez de vrais blocages (erreurs d'autorisation sur les appels API), contactez leur support via le lien fourni dans le bandeau. 🔑 Obtenir votre clé API Account Settings → API Keys app.easypost.com → Account Settings → API Keys app.easypost.com/account/settings?tab=api-keys 💳 Billing 🚛 Carriers 👤 Users 🔑 API Keys ⚙️ Administration Production API Keys No Production API Keys Found. Test API Keys No Test API Keys Found. ⚠️ Contrairement à Shippo, aucune clé n'est créée automatiquement Il faut cliquer sur "Add Additional API Key" (en haut à droite de la page) pour en générer une. app.easypost.com/account/settings?tab=api-keys Production Test Choisissez "Test" dans le menu déroulant — une clé commençant par EZTK... est générée. Copiez-la (même principe que Shippo : elle ne s'affiche en entier qu'une seule fois). Type de clé Préfixe Utilisation 🔴 Test EZTK... Simule de vrais transporteurs, aucun frais réel — utilisez celle-ci pour commencer 🟢 Production EZAK... Achète de vraies étiquettes, facturées réellement 🔗 Lier votre compte dans e-Vend Configuration générale → Expédition Espace vendeur → Configuration → Configuration générale 1 Désactivez Shippo, s'il était actif Un seul transporteur peut être actif à la fois — activer EasyPost désactive automatiquement Shippo. 2 Activez EasyPost Le bloc EasyPost apparaît dans la section Expédition, à côté de celui de Shippo. 3 Collez votre clé de test Le token EZTK... récupéré à l'étape précédente. 4 Confirmez le mode "Test" Aligné avec le type de clé collée. 5 Enregistrez Votre token est chiffré automatiquement — jamais visible en clair, même pour l'équipe e-Vend. 🏷️ Créer une étiquette — rien de nouveau à apprendre Une fois EasyPost actif, le bouton "🏷️ Créer une étiquette" sur une commande acceptée ouvre exactement le même modal que pour Shippo — dimensions, poids, liste de tarifs, achat en un clic. Le système sait déjà quel transporteur utiliser selon ce que vous avez activé — vous n'avez rien à choisir de plus. ⚠️ Le suivi automatique demande une étape de plus Le badge "🔄 Suivi automatique", l'historique détaillé (date, ville, statut) — tout ça fonctionne, mais seulement une fois le webhook configuré dans votre dashboard EasyPost. Sans cette étape, l'étiquette s'achète normalement, mais le statut ne se mettra jamais à jour tout seul. Voir la section suivante. 📡 Activer le suivi automatique L'étape qu'on oublie facilement — sans elle, le statut ne bouge jamais tout seul ⚠️ Sans cette étape, rien ne se met à jour automatiquement Acheter une étiquette fonctionne très bien sans ça — mais le statut de la commande restera bloqué sur "Étiquette créée" pour toujours, même si le colis est vraiment rendu à destination. C'est le webhook qui prévient e-Vend à chaque mouvement du colis. 🔑 Chaque vendeur doit le faire dans son propre compte Comme pour le token API, il n'y a pas de webhook partagé pour toute la plateforme — vous devez ajouter cette configuration dans votre dashboard EasyPost. Ça ne se fait qu'une seule fois par compte. 🔒 Nouveau — mise à jour de sécurité (action requise, même si votre webhook fonctionnait déjà) e-Vend vérifie désormais que chaque mise à jour de suivi provient réellement de votre compte EasyPost, et non d'une source extérieure qui tenterait de falsifier un statut de livraison. Bonne nouvelle avec EasyPost : le champ « Webhook Secret » existe déjà directement dans leur formulaire de création — pas besoin de contacter leur support comme avec Shippo. Si vous aviez déjà configuré votre webhook EasyPost avant cette mise à jour (probablement avec le champ secret laissé vide), le suivi automatique de vos commandes s'est arrêté. Il faudra soit éditer ce webhook pour y ajouter un secret, soit en créer un nouveau — puis coller ce même secret dans e-Vend (étape plus bas). 📍 Où trouver la section Webhooks app.easypost.com → Webhooks & Events (menu de gauche) app.easypost.com/account/webhooks-and-events 📦 Shipments ⭕ Trackers 📡 Webhooks & Events ⚙️ Shipping Settings Webhooks Test Webhooks No Test Webhooks Found. Add Webhook 👀 Un webhook "Production" existe peut-être déjà — normal Si vous aviez laissé l'option "Want to Send Tracking Updates?" activée pendant la configuration du compte, un webhook pointant vers wesupply.xyz apparaît automatiquement — c'est le service de pages de suivi brandées, pas lié à e-Vend. Laissez-le tel quel, n'y touchez pas ; ajoutez simplement le vôtre en plus. ➕ Ajouter le webhook e-Vend Cliquez sur "Add Webhook" — un formulaire s'ouvre : app.easypost.com/account/webhooks-and-events Add Webhook Environment Test ▾ Webhook URL https://e-vend.ca/api/webhooks/easypost Webhook Secret (Optional) secret Cancel Create Webhook Champ Quoi mettre Environment Test tant que vous utilisez une clé de test — passez à Production seulement en même temps que votre clé de production Webhook URL Exactement https://e-vend.ca/api/webhooks/easypost — copiez-collez pour éviter toute faute de frappe Webhook Secret Ne le laissez plus vide — entrez une valeur (une suite de caractères aléatoires suffit, ex: générée par un gestionnaire de mots de passe). C'est ce même secret que vous collerez dans e-Vend à l'étape suivante. ✅ Confirmation Cliquez "Create Webhook" . Votre webhook de test apparaît maintenant dans la liste, avec un identifiant unique ( hook_... ) : app.easypost.com/account/webhooks-and-events Test Webhooks URL: https://e-vend.ca/api/webhooks/easypost ID: hook_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 🔒 Ajouter ce secret dans e-Vend (obligatoire) Pour empêcher qu'une personne connaissant simplement un numéro de suivi puisse envoyer un faux message « livrée » à votre place, e-Vend vérifie maintenant la signature de chaque webhook reçu — en utilisant le même secret que celui collé dans le formulaire EasyPost ci-dessus. Sans lui, les mises à jour automatiques sont ignorées par mesure de sécurité (l'achat d'étiquette, lui, continue de fonctionner normalement). Espace vendeur e-Vend → Configuration → Configuration générale → 🏷️ Étiquettes d'expédition Cette section apparaît automatiquement, juste sous le bloc EasyPost — ce n'est pas un nouveau menu séparé, elle fait partie du même écran que celui utilisé à l'étape « Lier à e-Vend » plus haut. e-vend.ca/vendeur/configuration 🔒 Sécurité du suivi Empêche les faux statuts de livraison Secret webhook EasyPost ⚠️ Non configuré Coller le webhook_secret obtenu depuis easypost.com 💾 Enregistrer 🎉 Une fois le secret enregistré Le badge passe à « ✓ Configuré » et le suivi automatique reprend dès le prochain webhook reçu d'EasyPost — aucune autre action requise. Chaque mouvement de vos colis (pris en charge, en transit, livré...) est de nouveau envoyé automatiquement à e-Vend, pour toutes vos futures commandes. 🔧 Dépannage Les vrais problèmes rencontrés, et leurs vraies solutions ❌ "Something went wrong. Please contact support@easypost.com." Le message le plus frustrant qu'on ait rencontré — totalement générique , ne dit jamais la vraie raison. 🚫 Cause la plus probable : domaine de courriel refusé C'était notre cas exact — hotmail.com refusé silencieusement. Aucun outil de développeur, aucun VPN désactivé, aucun navigateur différent n'a révélé la vraie cause. Seul leur support (via courriel) a confirmé le blocage de domaine. Solution : utilisez un courriel de domaine professionnel dès le départ. 🔍 Comment creuser plus loin si ça persiste 1 Ouvrez les outils de développement (F12) → onglet Network Filtrez par "users" et retentez l'inscription. 2 Cliquez sur la requête POST /users en rouge (422) Onglet "Response" — cherchez le champ "errors". 3 Si "errors" est vide C'est le signe que ce n'est PAS un problème de formulaire (mot de passe, reCAPTCHA) — écrivez directement à support@easypost.com avec ce détail technique en preuve. Exemple de réponse 422 inutile (errors vide) { "error": { "code": "UNPROCESSABLE_ENTITY", "errors": [], "message": "Something went wrong. Please contact support@easypost.com." } } ⚠️ "Verification expired. Check the checkbox again." Le reCAPTCHA a une durée de vie courte — si le reste du formulaire prend trop de temps à remplir, il expire silencieusement. Cochez la case juste avant de cliquer sur "Sign up free" , pas au début. ❌ "Aucun tarif disponible" malgré tout de bon Contrairement à Shippo, EasyPost n'exige généralement pas d'activer manuellement Canada Post — les tarifs sont revenus directement dans nos tests. Si ça bloque quand même : Message vu dans le diagnostic Cause Unable to retrieve USPS rates for non-US origin Normal — USPS ne dessert pas les envois originant du Canada, ignorez ce message pour ce transporteur Only US outbound shipment is allowed for this account type Normal pour FedEx sur le compte partagé — ignorez, cherchez plutôt Canada Post/UPS dans la liste zip currently not supported (DHL) Le compte DHL partagé ne couvre pas cette zone — ignorez si un autre transporteur retourne un tarif valide Le plus important : regardez la section 🔍 Diagnostic du modal — tant qu'au moins un transporteur retourne un vrai tarif (généralement Canada Post), les autres messages d'erreur sont normaux et sans conséquence. ⚖️ Différences techniques avec Shippo Pour la curiosité — rien de ça n'affecte votre utilisation quotidienne Ces détails sont gérés automatiquement par e-Vend — vous n'avez jamais à y penser. Utile seulement si vous comparez les deux services ou lisez les diagnostics techniques. Aspect Shippo EasyPost Activation des transporteurs Manuelle (accepter les conditions de chaque transporteur) Généralement automatique via le compte partagé Compte requis pour tester Aucune carte nécessaire Carte de paiement exigée dès la configuration Identifiants dans les diagnostics Hash brut (ex: e4e3b696... ) Préfixés ( shp_... , adr_... , rate_... ) Achat d'une étiquette Le tarif seul suffit Le tarif ET l'identifiant de l'envoi sont nécessaires 30 étiquettes gratuites/mois ✅ Oui (0,07$ après) Modèle différent — 100$ de crédit au démarrage 💰 Le crédit de bienvenue EasyPost EasyPost offre 100$ de crédit sur vos premiers achats d'affranchissement une fois passé en production — un peu comme les 30 étiquettes gratuites/mois de Shippo, mais sous forme de crédit ponctuel plutôt que récurrent mensuel. 🔄 Remboursement d'une étiquette non utilisée Étiquette achetée par erreur, ou colis finalement expédié autrement ? EasyPost permet de demander un remboursement — directement depuis votre propre compte EasyPost , pas via e-Vend. 1 Ouvrir la page « Shipments » de votre compte EasyPost app.easypost.com — la liste de tous vos envois. 2 Sélectionner l'envoi concerné et demander le remboursement Disponible aussi via leur API (Shipment Refunds) si vous préférez automatiser, mais l'interface web suffit pour un usage ponctuel. ⚠️ Une fois l'étiquette scannée, c'est trop tard Comme chez Shippo, le remboursement n'est possible que si le transporteur n'a pas encore scanné l'étiquette (prise en charge réelle du colis). La demande doit être faite avant l'envoi effectif. 💡 Conseils pratiques Pour bien démarrer avec EasyPost ✅ Bonnes pratiques ✓ Utilisez toujours un courriel de domaine professionnel à l'inscription ✓ Cochez le reCAPTCHA juste avant de soumettre le formulaire ✓ Respectez l'exigence de 15+ caractères pour le mot de passe ✓ Choisissez toujours "API Integration", jamais "Shopify Integration" ✓ Ajoutez une carte de paiement même en mode test — obligatoire pour finir la configuration ✓ Utilisez le 🔍 Diagnostic pour distinguer les erreurs normales (USPS/FedEx hors zone) des vrais blocages ❌ Erreurs à éviter ✗ S'inscrire avec Hotmail, Gmail personnel ou autre domaine grand public ✗ Prendre trop de temps à remplir le formulaire (le reCAPTCHA expire) ✗ Paniquer face au message générique "Something went wrong" sans vérifier la vraie réponse via les outils de développement ✗ Activer EasyPost ET Shippo en même temps (impossible — l'un désactive l'autre automatiquement, mais évitez la confusion) ✗ Confondre la clé Test ( EZTK ) et Production ( EZAK ) au moment de configurer e-Vend ❓ Questions fréquentes Puis-je utiliser Shippo et EasyPost pour des commandes différentes en même temps ? Non — un seul transporteur actif à la fois, pour tout votre compte vendeur. Il faut désactiver l'un pour activer l'autre. Le bandeau "Security Verification Required" va-t-il disparaître ? Probablement, une fois la vérification standard du compte complétée de leur côté. Il n'a pas bloqué nos tests d'obtention de tarifs ni d'achat d'étiquette. Pourquoi certains transporteurs retournent une erreur même quand ça fonctionne ? Le compte partagé EasyPost inclut plusieurs transporteurs américains (USPS, FedEx, DHL) qui refusent naturellement les envois originant du Canada. Tant qu'un transporteur canadien (Canada Post, UPS) retourne un vrai tarif, ces erreurs sont normales et sans conséquence. Est-ce que je vais être facturé pendant mes tests ? Non, tant que vous utilisez votre clé de test ( EZTK... ). Toutes les adresses et envois créés en mode test portent l'indicateur "mode": "test" dans les réponses, et les PDF générés affichent "For Testing Purposes Only". 📋 L'essentiel à retenir Le piège n°1 : jamais de courriel personnel (Hotmail/Gmail) à l'inscription — domaine professionnel obligatoire Créer un compte : easypost.com → Sign up free → vérifier l'email → Account Setup (infos entreprise) → Account Configuration (préférences + carte obligatoire) → Integration Setup Toujours choisir : "API Integration" (Suite), jamais "Shopify Integration" (Nexus) Obtenir le token : Account Settings → API Keys → Add Additional API Key → Test Lier à e-Vend : Configuration générale → activer EasyPost (désactive Shippo automatiquement) → coller le token → Enregistrer Créer une étiquette : exactement le même bouton et modal que Shippo — rien de nouveau à apprendre Suivi automatique : configurez le webhook une fois (Webhooks & Events → Add Webhook → https://e-vend.ca/api/webhooks/easypost ) — sans ça, le statut ne bouge jamais tout seul 🔒 Sécurité (nouveau) : mettez un secret dans le champ « Webhook Secret » du formulaire EasyPost (plus vraiment optionnel), puis collez ce même secret dans e-Vend (Configuration → Étiquettes d'expédition) — sans ça, les mises à jour automatiques sont bloquées Erreur générique "Something went wrong" : vérifiez toujours la vraie réponse via les outils de développement avant de conclure à un bug Coûts : 100$ de crédit de bienvenue en production, transporteur toujours facturé séparément Remboursement d'étiquette : se fait entièrement dans votre compte EasyPost (Shipments), et seulement avant que le transporteur ne scanne le colis e-Vend.ca — Guide d'intégration EasyPost — Septembre 2026 v1.1 Ce guide est fourni à titre informatif. Pour toute question, contactez l'équipe e-Vend via la messagerie de votre tableau de bord.