---
title: "Getting started with the Headless SDK"
description: "Build a fully custom checkout page in React with full programmatic control over every step."
url: https://help.tagada.io/en/articles/64-getting-started-with-the-headless-sdk
collection: "For Developers"
updated: 2026-10-27
language: en
alternates: [fr]
---

# Getting started with the Headless SDK

Build a fully custom checkout page in React with full programmatic control over every step.

The **Headless SDK** (`@tagadapay/headless-sdk`) is for teams who want to **build their own checkout UI** in React, while letting TagadaPay handle the heavy lifting — payment processing, fraud rules, subscriptions, taxes, shipping, and order routing.

## When to use it

Use the Headless SDK when:

-   The standard customizable checkout doesn't match your design system
    
-   You want a non-standard flow (e.g. multi-step wizard, embedded checkout, mobile app)
    
-   You need pixel-perfect control over the checkout UI
    
-   You want to build on top of an existing React/Next.js app
    

## When **not** to use it

If the standard TagadaPay checkout meets your needs (logo, colors, sections, trust badges, languages all configurable), **don't go headless**. The Headless SDK requires a frontend developer to maintain.

## What you get

The SDK provides React hooks for:

-   Catalog, prices, and currencies
    
-   Cart and offer selection
    
-   Customer information and address validation
    
-   Payment methods (cards, wallets, alternative methods)
    
-   Order summary and post-purchase events (thank-you, upsells)
    
-   Pixel and analytics integrations
    

## Read the full docs

Full Headless SDK documentation, including hooks reference, examples, and the open-source starter kits:

→ [**docs.tagada.io/developer-tools/headless-sdk/introduction**](https://docs.tagada.io/developer-tools/headless-sdk/introduction)

The starter kits include working checkout examples you can clone and adapt:

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