Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
New: Stripe & TossPayments integration guides now available →
JWT tokens, guest carts, and customer identity for Storefront API
/customers/me, /orders), customers authenticate via JWT tokens.
curl -X POST https://api.headlesscommerce.io/v1/admin/customers/{id}/token \
-H "Authorization: Bearer sk_test_your_secret_key"
{
"token": "eyJhbGciOiJIUzI1NiIs...",
"expires_at": "2025-01-16T10:30:00Z"
}
X-Customer-Token header:
curl https://api.headlesscommerce.io/v1/storefront/customers/me \
-H "Authorization: Bearer pk_test_your_key" \
-H "X-Customer-Token: eyJhbGciOiJIUzI1NiIs..."
session_id:
const cart = await client.carts.create({
session_id: 'guest-session-123',
});
// After customer authenticates, merge guest cart
await client.carts.merge(guestCart.id, {
customer_token: customerToken,
});