This guide explains how to set up a Commerce Platform integration project for sellers who want to sell on Facebook and Instagram and manage orders via the API.
The Commerce API is in a closed, invite-only Beta program. Please work with your Facebook representative to get access if you have been invited to the program.
Before you begin the integration setup:
Learn more about what's considered unavailable/out of scope as you set up your integration:
When you can demonstrate how your App utilizes the Commerce API, submit it for App Review.
Before your app is approved via an App Review, your app can only use the API to access test commerce accounts. Once approved, it can then access real, production commerce accounts.
Your test commerce account comes with a test product catalog.
Set up a product feed to periodically update it using a CSV or XML file.
Update Inventory at a regular cadence. Facebook stores the inventory count provided and decrement it when customers place orders, until the inventory is updated via feed or API again. Products are marked as "out of stock" when inventory drops to zero.
Implement the Batch API to keep Facebook's perception of inventory up to date to avoid overselling.
The Order Management integration is unidirectional. Facebook does not make API calls to your systems.
Orders can be managed via Facebook's Commerce Manager manually, but the orders may not reflect directly into your ecommerce platform or order management system without an integration. Managing orders both in Commerce Manager and via an API integration could lead to inconsistency; be sure to give permissions to your commerce account only to trained personnel.
After you can perform the routine tasks on orders via API in your test commerce account, submit your App for App Review.
Customer service is an integral part of the post-purchase customer experience. After placing an order on Facebook or Instagram, a customer can request help with their order from your customer service team; for example, when their order is late or missing, when the order is damaged, or not as described or if they have another question.
When setting up a commerce account, provide a customer service email address. This email address will receive general questions and return and cancellation requests. Make sure that your customer service team is equipped to handle these requests within 2 business days. If your team is not responsive, a customer may open a Purchase Protection request with Facebook.
Make sure your customer service team can receive emails from Instagram sent from
@shopping.instagram.com. You may need to allow list these email domains. Learn more about email usage guidelines.
Prior to launch, the checkout experience is only visible to people who have a role on your Facebook Page.
You QA team can place orders via Facebook or Instagram checkout and validate that shipments are flowing through properly.
Prior to end-to-end testing, test individual components (for example, catalog, order management) in isolation as soon as each component is ready.
When you're ready to launch, in Commerce Manager, set your sales channels' visibility to Published. After launch, you should start receiving orders from real customers.