Shopify Commerce Platform

20 known error codes

CHECKOUT_ALREADY_COMPLETED Moderate

Checkout session is already completed and immutable.

FULFILLMENT_ORDER_CLOSED Moderate

Fulfillment order is closed and cannot accept new actions.

INVENTORY_QUANTITY_EXCEEDED Easy Fix

Requested quantity exceeds available inventory.

SHOPIFY_400_BAD_REQUEST Easy Fix

Request payload or query parameters are invalid for Shopify endpoint.

SHOPIFY_401_UNAUTHORIZED Easy Fix

Missing or invalid Shopify access token.

SHOPIFY_402_PAYMENT_REQUIRED Easy Fix

Shop/subscription plan restrictions block requested API feature.

SHOPIFY_403_FORBIDDEN Easy Fix

App lacks necessary scope/permission for this operation.

SHOPIFY_404_NOT_FOUND Easy Fix

Requested Shopify resource does not exist.

SHOPIFY_406_NOT_ACCEPTABLE Easy Fix

Request Accept/content negotiation is unsupported.

SHOPIFY_409_CONFLICT Moderate

Resource update conflict due to stale or concurrent state.

SHOPIFY_422_UNPROCESSABLE_ENTITY Easy Fix

Business validation failed while processing Shopify request.

SHOPIFY_423_LOCKED Moderate

Resource is temporarily locked and cannot be modified.

SHOPIFY_429_TOO_MANY_REQUESTS Moderate

Shopify API call limit exceeded for app/store.

SHOPIFY_500_INTERNAL_SERVER_ERROR Call a Pro

Unexpected Shopify server-side error occurred.

SHOPIFY_501_NOT_IMPLEMENTED Moderate

Requested capability is not implemented for this endpoint.

SHOPIFY_502_BAD_GATEWAY Moderate

Gateway received invalid upstream response within Shopify stack.

SHOPIFY_503_SERVICE_UNAVAILABLE Call a Pro

Shopify service unavailable due to maintenance/load.

SHOPIFY_504_GATEWAY_TIMEOUT Moderate

Gateway timed out waiting for Shopify backend.

SHOP_DOMAIN_INVALID Easy Fix

Shop domain is invalid or does not match app installation context.

WEBHOOK_TOPIC_INVALID Moderate

Webhook subscription topic is invalid for current API version.