Build a mobile app

A mobile app uses exactly the same Storefront API as a web frontend. The only difference is that it doesn’t run on the store’s domain, so identify the store with the publishable key on every request.

Client setup

final dio = Dio(BaseOptions(
  baseUrl: "https://api.vellaro.io/api/v1",
  headers: { "X-Vellaro-Key": "cx_pk_live_demo_XXXXXXXXXXXX" },
));
final res = await dio.get("/products", queryParameters: {"page": 1});

var req = URLRequest(url: URL(string: "https://api.vellaro.io/api/v1/products")!)
req.setValue("cx_pk_live_demo_XXXXXXXXXXXX", forHTTPHeaderField: "X-Vellaro-Key")

val req = Request.Builder()
  .url("https://api.vellaro.io/api/v1/products")
  .header("X-Vellaro-Key", "cx_pk_live_demo_XXXXXXXXXXXX")
  .build()

Login (POST /auth/login) returns an access_token (~30 min) and a refresh_token. Store the refresh token securely (Keychain / Keystore) and renew the access token with POST /auth/refresh. Send the access token as Authorization: Bearer on account-area calls.

Push notifications

Register the customer’s device token for transactional notifications (order shipped, etc.) through the Storefront API’s device-push endpoints — see the API Reference.

Images and payments work the same as on the web: image URLs must be prefixed with the origin, and the payment flow returned by POST /checkout must be completed with the gateway’s native SDK (Stripe/PayPal/…) when required.

Build a storefront Manage your store via API

⌘I

Get started

Guides

AI & MCP

Build a mobile app

Client setup

Push notifications

​Client setup

​Customer login & tokens

​Push notifications

Client setup

Customer login & tokens

Push notifications