Reference

Error catalog

Search this page for the exact message you see. Each entry names the cause and the fix — most resolve without contacting support.

On this page

Connection errors
Billing & access errors
Order & sync states
Refund failures

Connection errors

Message	Meaning	Fix
invalid_grant	The OAuth authorization code expired or was reused.	Restart the connect flow from Integrations.
insufficient_scope	Fewer permissions were approved than CrowPrime requested.	Reconnect and accept all requested permissions.
seller_not_professional	The Amazon selling plan does not allow API access.	Upgrade to a Professional selling plan on Amazon, then reconnect.
shop_not_active	The Etsy shop is in vacation mode or closed.	Reopen the shop, then reconnect.
rate_limited	The channel API quota is exhausted.	No action; CrowPrime retries automatically with backoff.
needs reconnect / expired	Authentication failed or the tokens passed their lifetime.	Use Reconnect with the same marketplace account.

invalid_grant

Meaning: The OAuth authorization code expired or was reused.
Fix: Restart the connect flow from Integrations.

insufficient_scope

Meaning: Fewer permissions were approved than CrowPrime requested.
Fix: Reconnect and accept all requested permissions.

seller_not_professional

Meaning: The Amazon selling plan does not allow API access.
Fix: Upgrade to a Professional selling plan on Amazon, then reconnect.

shop_not_active

Meaning: The Etsy shop is in vacation mode or closed.
Fix: Reopen the shop, then reconnect.

rate_limited

Meaning: The channel API quota is exhausted.
Fix: No action; CrowPrime retries automatically with backoff.

needs reconnect / expired

Meaning: Authentication failed or the tokens passed their lifetime.
Fix: Use Reconnect with the same marketplace account.

Billing & access errors

Message	Meaning	Fix
Billing suspended. Please resolve the outstanding balance…	A payment failed or the subscription ended; paid features are locked.	Fix payment under Settings → Billing.
This feature requires a higher plan	The action needs an entitlement your plan does not include (e.g. Amazon on a lower plan).	Upgrade under Settings → Billing, or use a feature your plan includes.
Organization limit reached	You already belong to the maximum number of organizations for your plan.	Leave another organization, or ask an Enterprise Admin for a seat exemption on the invitation.
You don't have enough credits…	Essential plan Crow AI balance is at zero.	Top up credits or wait for the monthly reset.
You have exceeded the N requests/hour limit	Fair-use rate limit (Professional/Enterprise) reached.	Wait for the hourly window to roll over.
Page not available for your role	Your role lacks the page permission.	Ask an Owner to change your role or grant an override.

Billing suspended. Please resolve the outstanding balance…

Meaning: A payment failed or the subscription ended; paid features are locked.
Fix: Fix payment under Settings → Billing.

This feature requires a higher plan

Meaning: The action needs an entitlement your plan does not include (e.g. Amazon on a lower plan).
Fix: Upgrade under Settings → Billing, or use a feature your plan includes.

Organization limit reached

Meaning: You already belong to the maximum number of organizations for your plan.
Fix: Leave another organization, or ask an Enterprise Admin for a seat exemption on the invitation.

You don't have enough credits…

Meaning: Essential plan Crow AI balance is at zero.
Fix: Top up credits or wait for the monthly reset.

You have exceeded the N requests/hour limit

Meaning: Fair-use rate limit (Professional/Enterprise) reached.
Fix: Wait for the hourly window to roll over.

Page not available for your role

Meaning: Your role lacks the page permission.
Fix: Ask an Owner to change your role or grant an override.

Order & sync states

State	Meaning	Fix
Needs attention	Oversold items, overdue shipments or failed pushes.	Open the queue and resolve each item.
currency mismatch	Order currency differs from the organization currency.	Finance reviews; amounts used the import-date rate.
Unlinked listing	An imported listing matched no product variant.	Link it manually or create a product from it.
Channel rejected a push	The marketplace refused a stock or price update.	Automatic retry with backoff; check the listing flag for the channel message.
Order has no shipping address	The channel did not provide an address; tax classification and fulfillment may fail.	Edit the address where the channel permits, or handle the order manually.

Needs attention

Meaning: Oversold items, overdue shipments or failed pushes.
Fix: Open the queue and resolve each item.

currency mismatch

Meaning: Order currency differs from the organization currency.
Fix: Finance reviews; amounts used the import-date rate.

Unlinked listing

Meaning: An imported listing matched no product variant.
Fix: Link it manually or create a product from it.

Channel rejected a push

Meaning: The marketplace refused a stock or price update.
Fix: Automatic retry with backoff; check the listing flag for the channel message.

Order has no shipping address

Meaning: The channel did not provide an address; tax classification and fulfillment may fail.
Fix: Edit the address where the channel permits, or handle the order manually.

Refund failures

Cause	Meaning	Fix
Refund exceeds remaining amount	The requested refund is larger than the still-refundable balance.	Lower the amount or settle in the seller portal, then record it.
Insufficient balance	The marketplace balance cannot cover the refund.	Top up or settle externally, then record it.
Already refunded	The amount was refunded before, possibly on the channel.	Check the credit notes; record the portal refund if missing.
Return state blocks the action	The channel's return is in a terminal state (complete, cancelled or rejected).	Handle further steps directly on the marketplace.

Refund exceeds remaining amount

Meaning: The requested refund is larger than the still-refundable balance.
Fix: Lower the amount or settle in the seller portal, then record it.

Insufficient balance

Meaning: The marketplace balance cannot cover the refund.
Fix: Top up or settle externally, then record it.

Already refunded

Meaning: The amount was refunded before, possibly on the channel.
Fix: Check the credit notes; record the portal refund if missing.

Return state blocks the action

Meaning: The channel's return is in a terminal state (complete, cancelled or rejected).
Fix: Handle further steps directly on the marketplace.