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 info@zap.com.ph. |
| 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 info@zap.com.ph. |
📩 Need more help? Contact us at info@zap.com.ph