Quickstart
Get your Storefront up and running — create a store, add a location, set up products, configure a payment gateway, and grab your API key.
Quickstart
This guide walks you through setting up a Storefront store, adding a location and products, configuring a payment gateway, and grabbing your API key — all from the Fleetbase Console.
Step 1 — Create a Store
Navigate to Storefront in the Fleetbase Console sidebar.
Click New Store.
Enter a Name, Description, and select your Currency.
Click Save. Your store is created and assigned a unique store_* API key automatically.
After creation, open the store to fill in its timezone, logo/backdrop, and contact info — see Creating a Store.
If you manage multiple stores, switch between them via the store selector at the top of the Storefront console before each per-store action.
Step 2 — Add a Store Location
A store location provides the pickup address when Fleet-Ops creates delivery orders.
Navigate to Storefront → Settings → Locations.
Click New Location.
Enter a Name (e.g., "Main Branch") and a Street Address. Fleetbase geocodes the address and pins it on the map.
Click Save.
Use the Schedule Manager on the location to set operating hours — the days and time windows when orders can be placed.
Step 3 — Create a Category and Product
Navigate to Storefront → Products.
In the category sidebar, click New Category, enter a name (e.g., "Burgers"), and save.
Open the category and click New Product.
Enter the Name, Description, and Price.
Upload a Primary Image.
Set Status to Published so the product is visible to customers (the alternative is Draft, which hides it).
Click Save.
Step 4 — Configure a Payment Gateway
Navigate to Storefront → Settings → Gateways.
Click New Gateway and select Stripe.
Enter your Stripe Publishable Key and Secret Key. Use test keys while building.
Enable Sandbox for testing.
Click Save.
For testing without a real gateway, you can enable Cash on Delivery instead — toggle Enable cash on delivery in your store's general settings (it isn't a gateway picker option).
Step 5 — Get Your API Key
Your custom frontend app (mobile or web) authenticates to the Storefront API using the store's public key.
Navigate to Storefront → Settings → API.
Copy the key (prefixed with store_). Pass it as a bearer token: Authorization: Bearer store_... on every API request.
Next Steps
- Core Concepts — understand how stores, networks, products, cart, and orders fit together
- Variants & Addons — add customization options to your products
- Networks — build a multi-vendor marketplace
- Customer Authentication — implement login for your customer app