Storefront API
Bring your own frontend. Shopemaa runs the commerce.
One storefront API for products, collections, search, carts, checkout and shopper accounts, with payments already wired to Stripe. Build with Next.js, Astro, a mobile app or a kiosk; Shopemaa handles payments and orders.
Why it matters
What changes with Storefront API
Building commerce yourself means carts, checkout, payments and order handling, all of which must stay secure and in sync.
Keep full control of the frontend and let Shopemaa run the commerce behind it: catalogue, checkout, Stripe payments, orders and stock.
- Build your frontend, not a payment system
- Safe retries, no duplicate orders
- Stock and orders in sync everywhere
Best for: Teams with their own frontend, mobile app or kiosk.
How it works
4 steps from sign-up to sale
Get your app key
Every request carries your store's app key.
Read the catalogue
Products, collections and search, with variants, images and availability.
Check out
Send the cart and get an order and a checkout link back. Payment runs through Stripe.
Listen for changes
Signed webhooks tell your systems about orders, products and stock.
What you get
Everything in Storefront API
One API
Products, collections, search, carts, checkout and shopper accounts.
Payments wired in
Checkout is already connected to Stripe, paid into your own account.
Safe retries
Send an Idempotency-Key with checkout, so a retried request never creates a second order.
Signed webhooks
For orders, products and stock. Webhooks come with Growth and above.
Your framework
Next.js, Astro or a static theme, built and hosted on Shopemaa Cloud, or any app you run.
One catalogue
Stock, prices and orders stay in sync with your storefront, checkout and links.
Example
Two requests from product list to checkout
Read a collection with your app key, then post the cart with an Idempotency-Key and get the order and its checkout link back.
GET /storefront/v1/products?collection=mugs&size=12
Shopemaa-App-Key: sfk_…
{ "items": [{ "slug", "title", "price", "images",
"variants", "availability" }], "page", … }
POST /storefront/v1/checkout
Idempotency-Key: 7c9e…
{ "lines": [{ "variant_id", "quantity" }], "email", … }
{ "order_id", "order_number", "checkout_url", … }One catalogue
API is one of four ways to sell
Add a product once and sell it everywhere. Stock, prices and orders stay in sync, so an order from Storefront API and an order from any other channel land in the same list.
Start selling with Storefront API
30 days free, no card needed. No commission on orders.