---
title: "Premiers pas avec le SDK Headless"
description: "Créez une page de paiement entièrement personnalisée en React avec un contrôle programmatique complet sur chaque étape."
url: https://help.tagada.io/fr/articles/64-premiers-pas-avec-le-sdk-headless
collection: "Pour les développeurs"
updated: 2026-10-27
language: fr
alternates: [en]
---

# Premiers pas avec le SDK Headless

Créez une page de paiement entièrement personnalisée en React avec un contrôle programmatique complet sur chaque étape.

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.

## Quand l'utiliser

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
    

## Quand ne **pas** l'utiliser

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.

## Ce que vous obtenez

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
    

## Lire la documentation complète

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**](https://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 :

→ [**docs.tagada.io/developer-tools/sdk/open-source-examples**](https://docs.tagada.io/developer-tools/sdk/open-source-examples)