Error Codes

The Facebook Graph API will output error codes attached to API responses. Catch these error codes and take action accordingly.

CodeError MessageActionCategory

1818111

Cannot Ship Order: Orders in state 'cancelled' cannot be shipped.

Self explanatory

Order Management

1818105

Cannot Refund Order: Orders in state 'cancelled' cannot be refunded.

Do not attempt to refund orders that are already cancelled

Order Management

1818015

Order already shipped: Payment has already been captured for this order and it can no longer be canceled or marked as shipped

Catch error, stop shipping

Order Management

1818050

Order Already Shipped: This order can't be canceled since it's already marked as shipped. To refund this order, go to Past Orders.

Order has shipped so it cannot be cancelled. Refund it instead.

Order Management

1818107

Order not charged: This order has not been charged. There is nothing to refund.

Double check why you're trying to refund this order; Payment was not captured on it. Catch error, do not continue

Order Management

1818048 / 1818049

Order Already Canceled: This order has already been canceled.

Catch error, stop trying to cancel

Order Management

2361076

Refund Unavailable: This order can't be refunded until the customer's payment method has been charged. Please wait a few minutes and try again.

Contact support

Order Management

2382021

Invalid 'retailer_id' for Item in Refund Request: We're unable to find the corresponding product in the refund request. Please make sure that the 'retailer_id' field has a valid value.

Make sure you're passing in a retailer_id if it's an item-based request

Order Management

2361091

Refund Item Tax Higher Than Charged Amount: The tax amount '$X' you are trying to refund for the item is higher than what the buyer was initially charged of that has not yet been refunded, '$Y' .

Double check dollar values on refund

Order Management

2361050

Concurrent Order Modification: Multiple requests are attempting to modify this order at the same time. Only one request can modify an order at a time.

Serialize your API calls and reduce the rate of your requests

Order Management

2361084

Missing or invalid shipment origin postal code: Missing or invalid shipment origin postal code.

Self explanatory

Order Management

2361086

Provided Tax Amount is Too High: The amount of tax provided is higher than the tax amount authed of '$X' set at order creation, and cannot be charged while fulfilling the order.

Self explanatory

Order Management

2382030

Cannot Refund Order: The total requested refund cannot be $0.

Self explanatory

Order Management

2382023

Cannot Refund Order: The requested refund for <PRODUCT_NAME> '$X USD' is greater than the current charged amount of '$Y USD'.

Self explanatory; Double check dollar values

Order Management

2361081

Pending Action.

Retry this request. This error comes when we try to perform updates on order while its being updated by other parallel request.

Order Management

2361009

Order cannot be acknowledged.

Order cannot be acknowledged, order has already been either cancelled, shipped or refunded. Do not attempt to acknowledge orders that are not in CREATED state.

Order Management

2382045

Duplicate fulfillment details provided: Order already has a fulfillment with these fulfillment tracking details.

You cannot use the same tracking number multiple times for multiple shipments. Each shipment requires a unique tracking number.

Order Management

2361357 / 2382322

Shipment must have at-least one item.

Self explanatory

Order Management

2382319 / 2382323

Item Has Already Been Refunded.

Self explanatory

Order Management

2382021 / 2382324

Invalid 'retailer_id' for Item in Refund Request.

We're unable to find the corresponding product in the refund request. Please make sure that the 'retailer_id' field has a valid value.

Order Management

2382030 / 2382325

Cannot Refund Order

The total requested refund cannot be $0.

Order Management

2382022 / 2382326

Cannot Refund Order

The requested shipping refund amount is greater than the current charged amount.

Order Management

2382052

Cannot Update Disabled CMS

Failed to update CMS because it has been disabled

Onboarding

2361163

Instagram User Already Onboarded To Another Commerce Account

Instagram user {username} is already onboarded to another Commerce Account. Please select a different Instagram user or deactivate the shop first.

Onboarding