Le Headless SDK (@tagadapay/headless-sdk) est destiné aux équipes qui souhaitent créer leur propre interface de paiement en React, tout en laissant TagadaPay gérer la partie complexe — traitement des paiements, règles antifraude, abonnements, taxes, expédition et routage des commandes.
Utilisez le Headless SDK lorsque :
Le checkout personnalisable standard ne correspond pas à votre système de design
Vous voulez un flux non standard (par ex. assistant multi-étapes, checkout intégré, application mobile)
Vous avez besoin d'un contrôle au pixel près sur l'interface de paiement
Vous souhaitez construire au-dessus d'une application React/Next.js existante
Si le checkout standard TagadaPay répond à vos besoins (logo, couleurs, sections, badges de confiance, langues tous configurables), ne passez pas en headless. Le Headless SDK nécessite un développeur frontend pour le maintenir.
Le SDK fournit des hooks React pour :
Catalogue, prix et devises
Panier et sélection d'offres
Informations client et validation d'adresse
Méthodes de paiement (cartes, portefeuilles, méthodes alternatives)
Résumé de commande et événements post-achat (page de remerciement, upsells)
Intégrations pixel et analytics
Documentation complète du Headless SDK, incluant la référence des hooks, des exemples et les kits de démarrage open-source :
→ docs.tagada.io/developer-tools/headless-sdk/introduction
Les kits de démarrage incluent des exemples de checkout fonctionnels que vous pouvez cloner et adapter :
