Ce guide explique la connexion à Printful quand Printful est explicitement indiqué comme disponible dans Intégrations → Traitement des commandes. Seul l’écran Intégrations en direct de votre compte fait foi ; cet article, un logo de fournisseur ou une URL directe ne prouvent pas la disponibilité. Si Printful est absent ou indisponible à cet endroit, arrêtez-vous : il est hors de votre périmètre actuel.
Une connexion réussie peut exposer les fonctions accordées par votre jeton Printful ; le comportement du catalogue, des commandes et des webhooks dépend encore de la boutique sélectionnée, des autorisations et de l’état actuel de l’intégration. Vérifiez le flux complet d’une commande associée et une référence acceptée par le fournisseur avant la production.
Si vous voulez d’abord la vue d’ensemble, voir comment fonctionne la connexion d’un fournisseur.
Avant de commencer
Un peu de préparation dans Printful facilite la connexion.
- Ayez un compte Printful prêt, avec votre boutique et vos réglages de paiement configurés. Confirmez les informations de paiement dans Printful avant de valider une commande de test et une référence de fournisseur.
- Décidez de quelle boutique Printful Composerie doit traiter les commandes. Si votre compte Printful a plusieurs boutiques, vous choisissez la bonne pendant la connexion.
- Si vous vous connectez avec une clé API, générez un jeton privé avec uniquement les accès que les étapes de configuration listent : commandes, produits et webhooks. Vérifiez ces autorisations dans Printful avant de les approuver.
La voie par clé API comporte trois courtes étapes numérotées : configurer votre boutique et vos informations de paiement, créer le jeton, puis le coller et choisir votre boutique. Elles renvoient directement au tableau de bord Printful et à la documentation de l’API Printful : vous pouvez ouvrir chaque étape dans un nouvel onglet et suivre.
Connecter Printful
Suivez uniquement la méthode de configuration affichée sur votre page Printful. Quand la connexion en un clic de Printful est configurée, la carte s’intitule « Connectez votre compte Printful » et commence par un bouton « Continuer avec Printful » ; le formulaire du jeton API est replié sous Utiliser plutôt une clé API. Quand elle n’est pas configurée, la carte affiche directement le formulaire du jeton API.
Ouvrir la page de connexion Printful
Allez dans le hub Intégrations du tableau de bord et ouvrez la section Traitement des commandes. Continuez seulement si la carte Printful affiche explicitement une action de configuration disponible, puis sélectionnez-la pour ouvrir la page de connexion.
Choisir comment se connecter
Utilisez l’une des méthodes de connexion affichées sur la page.
Pour vous connecter, sélectionnez « Continuer avec Printful », connectez-vous chez Printful et approuvez l’accès. Vous revenez directement à la page Printful dans Composerie. Si vous refusez ou si l’autorisation échoue, la page l’indique et rien n’est modifié. Le (i) à côté de « Uniquement le nécessaire pour les produits et les commandes » explique l’accès que Composerie demande et la réserve sur un seul webhook par boutique, ci-dessous.
Pour utiliser un jeton que vous gérez vous-même, sélectionnez Utiliser plutôt une clé API.
Coller votre jeton et trouver les boutiques
Si vous avez choisi la voie par clé API, collez votre jeton API privé dans le champ Clé API, puis sélectionnez Trouver les boutiques. Composerie valide le jeton auprès de Printful et relit les boutiques de votre compte.
Sélectionner la boutique à connecter
Une fois les boutiques trouvées, choisissez dans le sélecteur Boutique la boutique Printful que Composerie doit utiliser pour le traitement des commandes. Il liste chaque boutique de votre compte et démarre sur la première.
Terminer la connexion
Sélectionnez « Connecter Printful ». Le bouton n’apparaît qu’après que Trouver les boutiques a trouvé une boutique, et il demande qu’une boutique soit sélectionnée. Composerie enregistre votre jeton chiffré et note la boutique que vous avez choisie.
Si le parcours de connexion indique qu’un webhook a été enregistré, Composerie peut recevoir les événements de statut pris en charge pour cette boutique sélectionnée. Quand Printful renvoie un suivi dans un événement ou une réponse de statut pris en charge, Composerie peut l’enregistrer sur la commande fournisseur correspondante.
Confirmer la connexion
Après la connexion, la page Printful passe à sa vue connectée. Vérifiez que tout est correct.
L’en-tête affiche un statut Connecté. La ligne de suivi en dessous se termine par Dernière vérification, le moment où Composerie a confirmé pour la dernière fois que les identifiants fonctionnent toujours. La carte Connexion affiche la Boutique que vous avez choisie et Connecté depuis, avec la manière dont vous vous êtes connecté : « connecté avec Printful » ou « Clé API ». Servez-vous de ces valeurs, du statut de la connexion et d’un flux de test pour confirmer que l’identifiant fonctionne toujours. Le statut du fournisseur et le suivi n’apparaissent que si Printful les renvoie par un chemin de connexion pris en charge.
Dans la même carte, réglez la Devise d’achat sur la devise de facturation de votre compte Printful, pour que les coûts et les marges soient justes.
À partir de là, vous pouvez ouvrir le catalogue Printful et commencer à créer un produit. Sélectionnez Parcourir le catalogue dans l’en-tête de la page.
Pour importer des produits et choisir ce que vous vendez, voir parcourir le catalogue d’un fournisseur. Pour garder la connexion fonctionnelle dans le temps, voir garder la connexion d’un fournisseur en bonne santé.
Questions fréquentes
Connexion en un clic ou jeton API, que choisir ?
Utilisez l'une des méthodes affichées dans votre compte. Continuer avec Printful passe par l'écran d'approbation de Printful ; la voie par clé API sous Utiliser plutôt une clé API vous permet de contrôler vous-même l'identifiant et les autorisations.
Pourquoi ne vois-je pas le bouton Connecter Printful ?
Il apparaît une fois que Trouver les boutiques a trouvé une boutique sur votre compte. Collez votre jeton, sélectionnez Trouver les boutiques, puis vérifiez la boutique dans le sélecteur Boutique.
Le jeton fonctionne mais aucune boutique n'est apparue. Que faire ?
Créez d'abord une boutique dans Printful, puis revenez et sélectionnez de nouveau Trouver les boutiques. Composerie a besoin d'une boutique pour traiter les commandes avant de pouvoir se connecter.
Mon jeton API est-il en sécurité ?
Oui. Composerie enregistre le jeton chiffré et note seulement quelle boutique vous avez sélectionnée. Pour le renouveler, choisissez Modifier les identifiants dans le menu Plus d'actions et enregistrez un nouveau jeton ; l'actuel continue de fonctionner jusqu'à l'enregistrement. Une connexion faite par identification propose à la place Se reconnecter avec Printful à cet endroit.
Connecter Printful écrasera-t-il mon webhook existant ?
C'est possible. Printful autorise une seule configuration de webhook par boutique : l'enregistrement de Composerie remplace donc le précédent. Sur la carte de connexion en un clic, le (i) à côté de Uniquement le nécessaire pour les produits et les commandes le précise avant la connexion.
Si vous êtes bloqué, contactez le support et nous vous aiderons.
Étape suivante : parcourez le catalogue Printful pour ajouter votre premier produit.