Introduction
Headless Checkout gives developers full control over the checkout UI while relying on Purse for secure orchestration and payment execution.
The Headless Checkout is currently in beta. Documentation may evolve. Contact us at [email protected] with questions or feedback.
Why Use Headless Checkout?
The Headless Checkout SDK offers maximum flexibility for businesses that want to build a fully customized payment experience.
Unlike prebuilt solutions like Hosted Fields or Drop-in Checkout, the Headless SDK gives developers full creative freedom over the interface, behavior, and user experience — without compromising on security or functionality.
You are in control of:
- The Layout – Decide how, where, and when payment forms and buttons appear.
- The Design – Match your checkout perfectly to your brand with no visual limitations.
- The Behavior – Create advanced logic, conditional flows, and seamless transitions.
- The User Experience – Provide tailored experiences for different devices, countries, or payment preferences.
All the heavy lifting (method orchestration, validation, tokenization, submission) is handled by the Purse SDK, allowing you to focus on UX.
Key Concepts
Purse SDK handles:
- Available payment methods
- Payment amount split
- Payment execution via the orchestration API
You build:
- Checkout UI (form, buttons, display)
- Logic to handle method selection and form submission
Prerequisites
Before starting:
- Basic JavaScript, HTML, and CSS knowledge
- Purse API key and entity ID
- A client session
- Activated payment methods
- Modern browser (Chrome, Firefox, Safari, Edge)
Supported Payment Methods
The Headless Checkout supports a variety of payment methods with different integration modes:
| Payment Provider | Payment Method | Available |
|---|
| ACI | Credit Card | ✅ |
| Adyen | Apple Pay | ❌ |
| Adyen | iDeal | ❌ |
| Alma | cb2x | ❌ |
| Alma | cb3x | ❌ |
| Axepta | Credit Card | ❌ |
| Buybox | Giftcard | ✅ |
| CentralPay | Credit Card | ❌ |
| Checkout | Credit Card | ✅ |
| Checkout | Google Pay | ✅ |
| Checkout | Apple Pay | ✅ |
| Dalenys | Credit Card | ✅ |
| Easy2Play (Global Pos) | Giftcard | ✅ |
| Fintecture | Instant Payment | ✅ |
| Fintecture | BNPL | ✅ |
| Fintecture | Smart transfer | ✅ |
| Floa | cb3x | ❌ |
| GoCardless | SEPA | ✅ |
| HiPay | Bancontact | ❌ |
| HiPay | Credit card | ✅ |
| HiPay | MBWAY | ✅ |
| HiPay | Paybylink | ✅ |
| Illicado | Giftcard | ✅ |
| Ingenico ePayment | Apple Pay | ❌ |
| Ingenico ePayment | Bancontact | ✅ |
| Ingenico ePayment | Credit Card | ✅ |
| Ingenico ePayment | Google Pay | ❌ |
| Ingenico ePayment | iDeal | ✅ |
| Klarna | Intallment | ❌ |
| Maxxing | Loyaltycard | ✅ |
| Mercanet | Credit card | ✅ |
| Ogloba | GiftCard | ✅ |
| Oney | Credit Card | ✅ |
| Oney | PayOverTime | ❌ |
| Paybox | Credit Card | ✅ |
| Payline | Credit Card | ✅ |
| Payline | Ideal | ❌ |
| Payline | Bancontact | ❌ |
| Payline | MBWay | ✅ |
| Payline | Multibanco | ✅ |
| Paypal | Paypal | ✅ |
| Payzen | Credit Card | ✅ |
| Payzen | Apple Pay | ❌ |
| Payzen | Google Pay | ❌ |
| Payzen | Bancontact | ✅ |
| Redsys | Credit Card | ✅ |
| Riverty | Installments | ❌ |
| Riverty | Invoice | ❌ |
| Scalapay | Installments | ✅ |
| Scalapay | Paybylink | ❌ |
| Scellius | Credit Card | ✅ |
| Slimpay | SEPA | ✅ |
| Slimpay | Slimcollect | ✅ |
| Stripe | Credit Card | ✅ |
| Stripe | Apple Pay | ❌ |
| Sequra | Cb3x | ❌ |
This list is regularly updated as new payment methods become available.