Customer API

The Customer API allows stores to authenticate and provide a secure, read-only customer panel for their buyers.

It is designed for store customers, not merchants or platform administrators.

This API enables features such as:

• Passwordless customer login via email code
• Viewing basic customer profile information
• Accessing purchase history for a store
• Displaying customer spending statistics

Who this API is for

This API is intended for:

• Storefront customer dashboards
• Customer portals
• Order history pages
• Account pages within a store’s website or app

It is not intended for:

• Merchant dashboards
• Platform administration
• Financial reconciliation or payouts

For merchant access, use the main merchant API (Closed Beta Testing).

Authentication model

The Customer API uses two layers of authentication:

1. Store authentication (PK key)

All requests must include a Publishable Key (PK) in the Authorization header.

Example:

Authorization: pk_live_123

2. Customer authentication (session token)

Customers authenticate using passwordless email login.

After verifying a one-time email code, a customer session token is issued.

Customer-authenticated requests must include the session token using one of the supported headers:

• token
• x-customer-token
• x-customer-authorization

The token may be sent as a raw value or as a Bearer token.

Example:

x-customer-authorization: 30f38c2cd8dc82ee...

Versioning

The Customer API follows the same versioning and stability guarantees as the main Storrik API.

Breaking changes will be communicated in advance.