When the price defined by the seller is different from the price offered by the marketplace, orders may not be processed correctly. On VTEX, the order authorization flow allows you to control and automatically approve these orders by configuring Price Divergence rule. This article explains how sellers can create and edit Price Divergence rule and manually approve orders.
When no Price Divergence rule is created, the VTEX platform will behave differently for each scenario below:
- Orders created through the Marketplace interface: Will be automatically denied.
- Orders created via API: Will be automatically denied if the
isCreatedAsync
field is not sent. - Orders with Price Divergence related to manual discounts: Will be automatically authorized.
To use the Order Authorization flow, in cases of price divergence, you need to send the isCreatedAsync
field in the Place Fulfillment order API, regardless of the type of connector used. This scenario is valid for VTEX marketplaces, external marketplaces, certified connectors (partners), or native connectors.
When a seller is integrated with a native connector, such as Amazon, but has not configured a Price Divergence rule, orders with price difference errors remain pending until the rule is created. You can track them in your VTEX Admin by clicking on Marketplace > Connections > Orders.
We recommend that the seller creates the Price Divergence rule before configuring the integration with a native connector. Not following this recommendation does not prevent the integration from being configured, however, orders with divergent prices are held until the Price Divergence rule is created.
Creating Price Divergence rule
The Price Divergence rule is composed of one or more order authorization rules, which correspond to ranges between 0% and 100% of the order price. The configuration is done so that each range is associated with an automatic processing action.
To create a Price Divergence rule, the user must have a Super Admin (Owner) or OMS Full role. To ensure security in the management of your operations, please refer to the article Best practices for secure user management.
To create a price divergence rule, follow the steps below:
- In the VTEX Admin, go to Store Settings > Orders > Order Authorization, or type Order Authorization in the search bar at the top of the page.
- In the Price Divergence section, click
CREATE RULES
. - On the new page, click
CREATE RULES
.
You will see the following screen:

The All tab displays all configured authorization rules.
To create the first authorization rule, click on CREATE RULES. A new tab named 1st rule will be displayed. Clicking on this tab will display the configuration options.

To configure the 1st rule, you can increase or decrease the divergence percentage by dragging the ends of the bar. The > sign determines the start of the range, and the < sign determines its end. The range can be from 0% to 100%.
If you create a single authorization rule and it is less than 100%, orders with price variation outside the configured limit will not be integrated.
Once you have defined the authorization rule range, select one of the following options:
- Automatically authorize: Orders with a price difference within the defined range are automatically integrated.
- Automatically deny: Orders with a price difference within the defined range are automatically rejected and are not integrated.
- Create a task in VTEX DO for approval: For the configured range, the order is integrated, but remains in pending status, awaiting approval from an authorized user. In the Authorized persons field, you must enter the email addresses of the users who can manually approve these orders.
To configure a hierarchy of users responsible for approving orders, you must enter more than one email address and sort the registered users. You can change these users at any time by editing the order authorization rule. Please note that only users with the Super Admin (Owner) or OMS Full roles can edit the rule.
To create the 2nd rule, click on the plus sign. The same applies to creating a third or fourth rule, and so on. Once you click on the icon, the following interface is displayed:

Configure the new authorization rule and, once you have configured all the rules you want, click on the SAVE RULES button. You will see the following message: After saving, you can still edit or delete them at any time. Click OK to confirm. Once this is done, the Price Divergence rule will be created.
Once the Price Divergence rule is created, it is applied to all marketplaces where you act as a seller.
Editing Price Divergence rule
You can edit Price Divergence rule at any time. To do this, log in to your VTEX Admin, go to ORDERS > Order management > Order authorization > Price Divergence, and click on EDIT RULES.
On this page, you can delete the price divergence rule by clicking on DELETE RULES. This causes all configured authorization rules to be permanently deleted.
This action cannot be undone. If you want to reapply the rules, you need to configure them again. The same applies to the authorization rules that make up the Price Divergence rule.
On the same page, in the All tab, you can see the list of all the order authorization rules created. To delete an authorization rule, click on the DELETE RULE button next to the rule you want to delete.
If you want to edit an authorization rule, click on the tab corresponding to the rule you want to modify. The process for editing a rule is the same as for creating a Price Divergence rule.
Once you have made the desired changes, click on the SAVE RULES button, and then on OK.
Approving orders manually
When an authorization rule is configured with the option Create a task in VTEX DO for approval, this means that at least one user has been assigned to manually approve the order. Managing orders with price divergence is similar to managing orders from any other sales channel, such as a physical store or ecommerce.
It is important to regularly track orders in Orders module. To do this, go to Orders > All Orders. If they require manual approval, orders with price divergence errors remain pending, awaiting approval by an authorized user, defined when the authorization rule was created. Having at least two users authorized to perform manual processing is a good practice.
There are two ways to manually approve an order with price divergence:
Approving orders via Orders module
This is done on the All Orders page. To do this, follow the steps below.
- In the VTEX Admin, go to Orders > All Orders, or type All Orders in the search bar at the top of the page.
- Click on the order with the status
Waiting for manual authorization
. - Click on
Approve order
.
Approving orders via VTEX DO
VTEX DO manages tasks created by the modules of the VTEX platform. It allows authorized users to manually perform tasks such as approving or canceling orders, among others. Learn more in the article VTEX DO.
To approve an order with price divergence via VTEX DO, follow the steps below.
- In the VTEX Admin, go to Orders > All Orders, or type All Orders in the search bar at the top of the page.
- In the bottom right corner of the screen, click the VTEX DO component.
- Click the order pending approval.
- Click
Close
. - Click the
Authorize
option.