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
The starter kits include working checkout examples you can clone and adapt: