Shopify Order Error Handling
- Prateek Kaushik (Unlicensed)
GET API
Reconciliation of Create Orders
https://{{store-name}}.myshopify.com/admin/api/2021-04/orders.json?fulfillment_status=unfulfilledReconciliation of Cancelled Orders
https://{{store-name}}.myshopify.com/admin/api/2021-04/orders.json?status=cancelled
POSSIBLE ERROR RESPONSES
In the following table, the Maximum number of cases are covered with Request, Response with Status Code and the Possible Reason behind these errors.
Case # | REQUEST | RESPONSE STATUS CODE | POSSIBLE REASON | Retryable |
|---|---|---|---|---|
#1 | No Access Token provided | 401 UNAUTHORIZED |
|
|
#2 | Invalid Access Token provided | 401 UNAUTHORIZED |
|
|
#3 | Not having required Scopes in the Access Token to make HTTP REQUEST on an API | 403 FORBIDDEN |
|
|
#4 | “store name“ passed for URL preparation | 404 NOT FOUND |
|
|
#5 | Making HTTP GET requests more than the Shopify Store throtlling limit | 429 TOO MANY REQUESTS |
|
|
#6 | HTTP Request is correct but 5XX is returned by Shopify | 5XX Errors |
|
|
1. 401 UNAUTHORIZED:
Definition: We have two Scenarios here given as following:
Case a. Credentials Not Provided: If the credentials are not provided while making the HTTP Request, then the server will refuse to accept and will throw 401 Unauthorized error. For e.g: Authentication Token is not provided then the server will not accept the HTTP request.
RESPONSE
STATUS CODE: 401 Unauthorized
{
"errors": "[API] Invalid API key or access token (unrecognized login or wrong password)"
}
Case b. Credentials Are Provided: If the credentials are provided but still server is throwing 401 Unauthorized error then its most likely that the Authentication token is expired and we need to generate new Access Token using the Refresh Token which is saved while generating Authentication/Access Token for the very first time.
RESPONSE
STATUS CODE: 401 Unauthorized
{
"errors": "[API] Invalid API key or access token (unrecognized login or wrong password)"
}
2. 402 PAYMENT REQUIRED:
Definition: The requested shop is currently frozen. The shop owner needs to log in to the shop's admin and pay the outstanding balance to unfreeze the shop.
RESPONSE
STATUS CODE: 402 Payment Required
**NOTE: Need to figure out how to get this error3. 403 FORBIDDEN:
Definition: If the scopes related to order is not present in the Access token, then this error can occur.
RESPONSE
STATUS CODE: 403 Forbidden
{
"errors": "[API] This action requires merchant approval for read_orders scope."
}4. 404 NOT FOUND:
Definition: If the following parameters required to make an HTTP request for Order API are not correct then a 404 NOT FOUND Error can take place:
store name
RESPONSE
STATUS CODE: 404 Not Found
5. 429 TOO MANY REQUESTS:
Definition: The request was not accepted because the application has exceeded the rate limit. See the API Call Limit documentation for a breakdown of Shopify's rate-limiting mechanism.
RESPONSE
STATUS CODE: 429 Too Many Requests
{
"errors": "Exceeded 2 calls per second for api client. Reduce request rates to resume uninterrupted service."
}6. 5XX RESPONSE CODE:
Definition: Following Possible 5XX errors can take place:
i. 500 Internal Server Error An internal error occurred in Shopify. Please post to the API & Technology forum so that Shopify staff can investigate.
ii. 501 Not Implemented The requested endpoint is not available on that particular shop, e.g. requesting access to a Plus-specific API on a non-Plus shop. This response may also indicate that this endpoint is reserved for future use.
iii. 503 Service Unavailable The server is currently unavailable. Check the status page for reported service outages.
iv. 504 Gateway Timeout The request could not complete in time. Shopify waits up to 10 seconds for a response. Try breaking it down in multiple smaller requests.
Draft: Proposed Solutions
1. 401 UNAUTHORIZED: Configure Google Cloud Alert System
call GET /connection/{{connectionID}}/generateToken |
call the connectionChannelData Method |
Retry with new token |
Log the response(success or failure) and retry only once |
For failure case, configure google cloud alert system |
Retry: Once the new Access Token is generated then we have to make the HTTP Request and the following Scenarios can take place:
i. Server throws 401 Unauthorized again, in this case, we just have to log the response and need to configure Google Alert System.
ii. Server gives 2XX Status Code, then Proceed as decided.
2. 402 PAYMENT REQUIRED: Configure Google Cloud Alert System
**NOTE: Need to figure out how to get this errorResolution: Nothing to be done here.
Retry: No Retry in this case.
3. 403 FORBIDDEN: Configure Google Cloud Alert System
**NOTE: Need to generate a token which does not have the required scope of the Shopify APIResolution: To rectify 403, Possible scenarios and steps can take place:
i. Check the appropriate scopes which are required to perform the HTTP Request. It is necessary to have the valid scopes in the token with which the HTTP Requests are taking place. Without Appropriate and required scopes, HTTP Requests will not succeed and will continue giving 403 Forbidden Error.
ii. Scopes are valid in the token while making the HTTP Request but the Server is still throwing 403 Forbidden Error due to invalid HTTP Method defined. For e.g, if the API does not require any Request Body or it is just a GET Request API, then it is necessary to check the HTTP Method set for this API in the code. If the HTTP Method is set other than GET, let's say PUT, POST, DELETE etc then the Server will continue giving 403 Status Code
Retry: No Retry in this case because retrying the same HTTP request without auditing the code or Access Token will not help in succeeding.
4. 404 NOT FOUND: Configure Google Cloud Alert System
Resolution: We need to find the correct parameters passed while making the HTTP Request, until and unless we have the correct URL and the correct Parameters to pass in the Request, HTTP 404 NOT FOUND Error will continue coming and will not succeed on Retry.
Retry: No Retry in this case until we have the correct URL and Correct Parameters to pass.
5. 429 TOO MANY REQUESTS: Configure Google Cloud Alert System
Resolution:
Retry