Headdy Documentation
A headless storefront API for Craft Commerce
Installation
Requirements, install, your first API key, your first cart, and what Lite and Pro each cover.
Configuration
Settings, API keys and scopes, CORS, payment redirects, customer accounts, GraphQL schemas, webhooks and permissions.
Building a storefront
A cart, a checkout and a payment from a JavaScript front end, end to end, plus customer accounts and GraphQL.
API reference
The v1 contract — every endpoint, the response envelope, money, error codes, GraphQL and webhook signing.
Troubleshooting
What to check when a request is refused, a browser reports a CORS error, a payment won't redirect, or a token stops working.
FAQ
The questions worth answering before putting a headless front end on Craft Commerce.