Important: When developing websites or building apps with Blocks, use Velo service plugins.
The Catalog service plugin lets you become a Wix catalog provider. This means you can integrate any external repository of sellable items with the Wix eCommerce platform. Wix calls the Catalog service plugin to get up-to-date information about items whenever a cart or checkout is updated, and when an item is added to an order.
With the Catalog service plugin, you can:
The Catalog service plugin enables you to maintain a complex and dynamic external catalog while being confident Wix can retrieve the latest information for every action.
For example, after a customer adds a particular item to their cart, one of the following details might change in your dynamic catalog:
With the Catalog service plugin, you can be sure that when the customer moves the item from their cart to their checkout, Wix will retrieve the updated details from your catalog automatically.
It's important to note the following points before starting to code:
To integrate an external catalog with the Wix eCommerce platform:
Implement the Get Catalog Items method so Wix can retrieve the information it needs about specific items.
Note: When Wix calls your app's implementation of the Get Catalog Items method, your app receives a request containing a payload as an encoded JWT.
Create an app in your Wix Studio workspace and add a catalog integration extension.
To enable your Wix app to communicate with your external catalog:
Select an app from the Custom Apps page in your Wix Studio workspace.
Go to Extensions in your app's dashboard.
Click Create Extension.
Scroll down to Ecom Catalog and click Create.
In the JSON editor, assign the URI where the Catalog service plugin is implemented to deploymentUri
. For example:
Note: Other fields in the JSON editor are reserved for future functionality.
Click Save.