API v2 · Recommended

Build the storefront.
Shioja handles the supply chain.

Use one API to present in-stock products, price delivery, create orders safely, and follow fulfilment. Start in test mode, then move the same integration to live keys.

Make your first request See how it works
01
DiscoverSearch the live catalogue
02
PricePreview delivery
03
OrderCharge once, fulfil safely

The model

Your customer sees your store. Shioja works underneath it.

A

Your application

Your website, mobile app, social-commerce tool, or internal ordering system owns the customer experience and sends requests using its own Shioja keys.

B

Shioja catalogue

Product listings are served from a versioned, cached read model. Search finds matching IDs and Shioja hydrates them from the same catalogue.

C

Delivery and fulfilment

A v2 delivery address is validated and priced again when the order is created, before the atomic wallet check and deduction.

Choose a path

10 min

First integration

Keys, test mode, catalogue request, delivery preview, and order.

Start building → Critical flow

Safe checkout

Idempotency, server pricing, wallet charging, and retries.

Design checkout → Existing clients

Move from v1

Adopt the structured v2 address flow without breaking v1.

Plan migration →