Quick start

Create storefront credentials

1. Open <AUTH_SERVER>/account?tab=custom-storefronts and sign in. You must be an owner or admin of the organisation.
2. In Custom storefronts, type a storefront name (for example Main website) and select Create credentials.
3. Copy the Client ID (sf_…) and the Client secret (sfs_…).
4. Set them as environment variables on your storefront server:

AUTH_CLIENT_ID=sf_xxxxxxxxxxxxxxxxxxxxxxxx
AUTH_CLIENT_SECRET=sfs_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Read your store settings

This call needs no token:

curl "$API_BASE/api/customer/v1/operator" -H "X-Store-Name: your-store-name"

Get a guest token

This call needs the credentials:

curl -X POST "$AUTH_SERVER/customer/anonymous" \
  -u "$AUTH_CLIENT_ID:$AUTH_CLIENT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{ "store": "your-store-name" }'

The response contains an access_token.

Call an endpoint that needs a token

curl -X POST "$API_BASE/api/customer/v1/cart" \
  -H "X-Store-Name: your-store-name" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Run the example storefront

The storefront starter is a small Next.js application that does the full flow: upload, price, sign-in, checkout, and order tracking.

git clone https://github.com/phas-io/storefront-starter.git
cd storefront-starter
cp .env.example .env.local   # then fill in the values
npm install
npm run dev

The repository also contains an agent skill in skills/phasio-storefront. It gives a coding agent the setup procedure and the API rules. Refer to the README of the repository for the installation.