Error Messages

Find out what each error means and how to resolve it.

Sometimes errors happen during order processing or courier booking. Here’s a complete guide to help you understand and resolve them quickly.

---

📱 Merchant App Errors

These appear while using the In-Store Merchant App.

Title	Message	Description
Session Expired	Your session has expired. You can log in again.	Your location might be unlinked in Shopify.
BadRequest	Oops, something's not right.	App and server may be out of sync. Try again later.
InternalErr	Oops, something's not right.	Server is temporarily down. Try again later.
NotFound	Oops, something's not right.	App and server may be out of sync. Try again later.
MalformedRes	Oops, something's not right.	App and server may be out of sync. Try again later.
No internet connection	Please check your connection and try again.	Reconnect or move to a stronger internet signal.

📦 Order Action Errors

These appear when performing actions on orders in the Merchant App.

Title	Message	Description
Failed to cancel/accept/process order	Something went wrong. Try again.	Order not found. Pull down to refresh and sync the app.
Failed to mark as cash received	Something went wrong. Try again.	Order not found. Pull down to refresh and sync the app.

🛒 Product Action Errors (Enterprise Plans Only)

These appear while using Product Availability in the Merchant App.

Title	Message	Description
Mark product as available	Process failed. Try again.	Product not found. Refresh the product list to sync.
Mark product as unavailable	Process failed. Try again.	Product not found. Refresh the product list to sync.

🔐 Authentication Errors

These appear when attempting to link a branch location.

Title	Message	Description
Can't login	Please make sure to get a valid Install URL from the E-store admin.	May be due to an incorrect URL, missing location, or an expired link.

🚚 Delivery Integration Errors

These appear when using the Book a Rider feature.

Common Error Codes

Code	Title & Message	Description
1001	Order not found	Confirm order exists in Shopify admin.
1002	Store location not found	Confirm location exists in Shopify admin.
1003	Missing mobile number	Customer's mobile number is required to book a rider.
1004	Store not found	Confirm the store exists in Shopify admin.
1005	Missing access keys	Delivery provider keys are missing or disconnected.
1006	Invalid mobile number	Format of mobile number is invalid.
1007	Invalid access keys	Keys are invalid or expired.
1008	Missing delivery address	No delivery address found in the order.
1009	Invalid store location	Store coordinates are incorrect.
1010/1011	Invalid mobile number	Unrecognized format for customer/location mobile number.
1012	Invalid details	Customer or location contact info is incorrect.
1013	Insufficient balance	Wallet balance is not enough to cover booking cost.
1014	Invalid Google Maps API key	Maps API key is invalid or has incorrect permissions.
1015/1020	Something went wrong	Geocoding error. Retry or contact support.
2001	Booking not found	Booking does not exist. Try again.
2002	Provider not found	Delivery provider details are missing or incorrect.
2003/2005	Store not found	Confirm the store exists in Shopify admin.
2004	Order not found	Confirm the order exists in Shopify admin.
2006	Provider cannot be reached	The delivery provider is temporarily unavailable.
2007	Invalid access keys	Keys are invalid or missing.
2020	Something went wrong	Retry or contact [e-mail].
3001	Booking not found	Booking does not exist.
3003	Insufficient balance	Balance is not enough to cover the cancellation fee.
3004	Provider not found	Check delivery provider credentials.
3006	Order not found	Confirm the order exists in Shopify admin.
3007/3008	Something went wrong	Temporary issue. Retry or contact support.
3009	Provider cannot be reached	Provider is temporarily unavailable.
3010	Invalid access keys	Keys are invalid or expired.
3020	Something went wrong	Retry or contact [e-mail].

---

📩 Need more help? Contact us at [e-mail]