Overview
Settings → Fulfillment Methods (Hosted Shopfront sidebar) defines how shopfront customers receive orders. Kiosk and QR do not show a fulfillment picker, even if methods exist.
Before you start
- Header: Hosted Shopfront.
- Settings → Checkout: enable Enable Fulfillment Methods.
- Set store Country under Store Settings → General. Address search and Uber Direct need a country on the store.
- For UberEats or other external delivery, complete Pickup Address on Checkout (map search, then phone).
Address roles (General vs pickup vs delivery)
Store Rav uses three different addresses. They are saved in different places and must line up for Uber Direct (UberEats) to quote and deliver.
| Address | Where you set it | What it is used for |
|---|---|---|
| General (business) address | Store Settings → General | Country controls shopfront Mapbox delivery search, default currency, and whether Uber Direct can be offered. Street, city, and state on General are what customers see on the shopfront (header, about). Uber does not use General street as the courier pickup location. |
| Pickup address | Settings → Checkout → Pickup Address (Hosted Shopfront) | Origin for Uber and other external delivery: quotes and couriers pick up here. Requires map search plus phone after an address is selected. If pickup is missing, checkout cannot get an external delivery quote. |
| Customer delivery address | Shopfront cart (fulfillment step) | Drop-off for the order. The customer must choose a Mapbox suggestion (typing alone is not enough). Suggestions follow the store Country from General. The address must be in a region your Uber credentials can serve. |
UberEats (Uber Direct BYO): Client ID and Secret must match your store’s region (same country as General). That does not replace pickup — you still need a complete Checkout pickup address in that region. For live delivery, align General country, Checkout pickup, and the customer’s delivery address (for example all in Canada when credentials are Canada-issued).
See How to configure checkout for where pickup is saved.
How to use it
Pickup address
- Settings → Checkout → Pickup Address.
- Search the address, confirm the filled fields, enter phone (with country calling code), save.
- If search is unavailable, the Checkout page tells you to set store country in General settings first.
Manual method
- Fulfillment Methods → Add, type Manual / Internal.
- Name, Order Fulfillment ETA (1–720 minutes), Cost, Require Customer Address, Description.
- Status is set on edit (Active/Inactive). Methods follow Test/Live mode like payments.
UberEats (Uber Direct)
- Add a method with type UberEats.
- Set store country in General settings before connecting. The form notes that Uber Direct availability varies by country: confirm coverage with Uber before going live.
- Enter Client ID and Client Secret (required to save). Use credentials issued for your store’s region.
- Check I confirm Uber Direct is available in my store's region and my credentials are issued for that region.
- Cost is hidden (not used). Customer address is required.
- Save. Orders using this method are always auto-accepted.
- On the shopfront, a quote is ready only when Uber says it is available and returns a quote id. The fee on that quote can be zero, and that zero is saved as the delivery charge. If Uber says the quote is unavailable, checkout shows Uber’s message and Place Order stays blocked.
List views filter methods by current Test/Live mode.
Understanding the options
| Field | Meaning |
|---|---|
| ETA | Preparation/fulfillment minutes. |
| Cost | Fee on the order (manual). |
| Require Customer Address | Shopfront collects an address. |
| Enable Fulfillment Methods | Shopfront checkout asks the customer to choose a method. |
| Uber Direct region confirmation | Required when saving UberEats. Invalid credentials or region mismatches fail at quote or order time. |
Important
- Without Enable Fulfillment Methods, shopfront may skip the picker.
- Fulfillment-only taxes need a selected method; they will not apply on kiosk/QR.
- Pickup address map search needs a store country.
- Checkout pickup is not the same as General business address. Uber uses pickup only; customers see General on the storefront unless your theme copy references pickup elsewhere.
Common problems
Problem
Customers cannot choose delivery.
What to check
- Header is Hosted Shopfront (not kiosk/QR. those apps have no picker).
- Enable Fulfillment Methods is on.
- At least one active method exists in the current Test/Live mode.
Problem
Pickup address search is missing.
Solution
Open Store Settings → General, set Country, and save. Then return to Checkout.
Problem
UberEats orders fail after save.
Solution
Confirm Client ID and Secret for the current mode, pickup address, region confirmation, and that the store is Live if you are not testing. Contact Store Rav support if credentials look correct.
Problem
Uber shows Delivery not available or quotes never finish, but General address looks correct.
What to check
- Checkout pickup address is set and in the same country as your Uber credentials (General street alone is not sent to Uber).
- General → Country matches that region (Mapbox and Uber gating use country, not pickup).
- On the shopfront, the customer selected a Mapbox suggestion for delivery in that country (not a leftover address from another country in the browser cart).