Connect your Magento 2 store backend to Converge
Set the Configuration
Open your terminal or command prompt and navigate to the root directory of your Magento 2 installation.
Execute the following command to set the oauth/consumer/enable_integration_as_bearer
configuration option to 1
.
Verify the Configuration
1
.Navigate to your Magento Integration Settings
Generate your Magento Admin Access Token
Sales/Operations/Orders/Actions/View
as your scope.Create a new Server-side source in Converge
{Storename} Store Backend
Connect the Source to Magento
https://
, e.g. https://myshop.com/rest
myshop.com
.
Feel free to leave this blank if your store is hosted on the same domain.If your storefront is hosted on a different domain than your API, please provide the domain in the Storefront domain.
This domain should match the domain on which the Magento Storefront Module was installed.
For example, www.example.com
.
Pay attention to provide the full domain here. Depending on your setup, it might be necessary to include www.
, or not.
You can inspect the full domain in the browser’s address bar when you visit your storefront. Click on the address bar to see the full URL.
You can scope your Magento integration to only include orders from a specific store view. This may be useful if you have multiple store views in your Magento installation and want to separate them out in Converge.
You can customize where in the order lifecycle Converge starts tracking orders. This can be useful if you want to exclude unconfirmed orders or only track orders that have been paid for.
The default order status lifecycle is documented by Magento here.
Default lifecycle example
For the default order lifecycle, you could specify processing
to only track orders that have been paid for.
The order reaches the processing
status after the payment has been confirmed, before it is shipped.
Converge will track the order whenever it reaches any of the specified status. The order may still go through multiple transitions after this point.
Depending on your Magento installation, the order lifecycle may have been customized. Make sure to consult on any changes with your Magento developer.
This integration auto-tracks the following events on the server with all properties available according to the Converge Event Spec.
Event Name | Event Description |
---|---|
Placed Order | When a customer places an order. |