Order Management

After a seller has been successfully onboarded and their inventory has been uploaded to Facebook, their products are ready to be purchased by consumers.

Order Fulfillment

Orders placed on Facebook or Instagram are put on hold during at least the first 30 minutes during which time they are being processed by our internal systems. This delay is also designed to give chance for buyers to cancel their orders in case of remorse.

After Facebook has verified that a given transaction is legitimate and the remorse period has elapsed, the corresponding order will be made available for you to fulfill.

You can fetch orders at any time, but will only be able to access customer details and change the state of a given order after it has been released from internal processing.

Order Item Status — You can now request the status field on the order items returned by the List Order Items query. You will get a status breakdown for each order item in response. For example: {"in_progress": 0, "fulfilled": 1, "cancelled": 1}.

Order Fulfillment Tasks

You are responsible for the following order fulfillment tasks:

  • Acknowledge new orders.
  • Mark an order as shipped, with a carrier code and tracking number.
  • Mark an order as canceled, to notify the buyer of fulfillment problems and refund their entire order.
  • Mark an order as refunded, to emit a partial or full refund to the customer.

You can perform these actions manually using the Commerce Manager order management interface, or by integrating your Order Management Solution (OMS) with our Order Management API.

Facebook and Instagram will send in-app notifications to users for all of the actions above, including emails. Because of this and to avoid double communication, you must suppress the corresponding emails on your end.


Orders are automatically acknowledged if you are managing orders manually using Commerce Manager. If you are managing orders through an API integration, you need to acknowledge orders to let us know that you've seen the order and are ready to fulfill it.

You can pass an merchant_order_reference during acknowledgement. This represents the unique identifier of the order as known by your internal Order Management Solution. This ID will be displayed on the receipt and can be referenced by users when contacting your teams for support. If you do not provide this optional field, you need to ensure that your teams are trained to support customers using the Facebook or Instagram order ID.


When you are ready to ship products to customers, mark the order as shipped.


  • You must specify the shipping carrier and provide a valid shipping tracking number as part of this operation. This information is used to help customers get shipping notifications and track their packages.
  • You must ship orders within the handling time that you specify.
  • Your shipping method must take no longer than 7 days once the order is processed.


Cancelations can be initiated by the buyer or the seller.

  • Buyer initiated cancellations — Buyers have 30 minutes to cancel their orders via the order summary in their Facebook or Instagram app. Buyers can contact your support team to process cancellations past this 30-minute "buyer's remorse" period.
  • Seller initiated cancellations — Orders can only be canceled when they are marked IN_PROGRESS. Shipped orders have to be refunded instead. Seller initiated cancellations are typically made if a customer contacts your support team to request a cancellation after the 30 minutes buyer remorse period.


Refunds are initiated by you, and only apply to shipped orders. Typically you would refund an order if a customer contacts your support team to signal a problem with the product or the shipment. You can request a partial or full refund, which triggers a reverse payment transaction by Facebook to the buyer. This operation also deducts the corresponding amount from your balance and be made available in your cash report.


Unless a product is marked as a final sale, you are required to provide support for returning goods. You must give buyers at least 30 calendar days to return an item. Buyers can go to their order summary to initiate a return, which initiates one of the following flows:

  • Opens your return website, if you have configured a Returns URL in your shop setup.
  • Sends an email to your customer support contact address registered in your shop setup.

If you have provided a return label in the package, customers can also return items directly without using the Facebook or Instagram app. When your warehouse team has confirmed items have been received and in good condition, you should initiate a refund.

Order History Report

To help with order fulfillment, we also allow sellers to export their order history directly from Commerce Manager, go to the Orders tab, and click Download Order History.

Sample Order History Report

Report Type Link

Order History Report