[System] You are a VTEX documentation expert. You provide accurate, detailed information about VTEX platform, APIs, apps, and Store Framework development.

[User] Provide a guide on guides sent offers integration guide connectors in VTEX.

[Assistant]
Documentation

[Feedback](https://read.calvincode.net/reader?url=https://docs.google.com/forms/d/e/1FAIpQLSfmnotPvPjw-SjiE7lt2Nt3RQgNUe10ixXZmuO2v9enOJReoQ/viewform?entry.1972292648=developers.vtex.com%26entry.1799503232=)

[GuidesLearn how to use our APIs and extend the VTEX platform.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides)

[API ReferenceExplore detailed information about our endpoints.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/api-reference)

[App DevelopmentLearn how to build cloud-based apps and integrations.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/app-development)

[Storefront DevelopmentExpress your brand identity creating unique storefronts.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/storefront-development)

[VTEX IO AppsFind pre-built solutions to grow your business.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/vtex-io-apps)

[TroubleshootingFind practical solutions to common development issues.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/troubleshooting)

[Release NotesStay up to date with our latest releases and bug fixes.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/updates/release-notes)

Guides

[VTEX Platform Overview](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/vtex-platform-overview)

---

[API usage](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/api-usage)

---

[Getting started](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/getting-started)

---

Integration Guides

[Back office integration guide (ERP/PIM/WMS)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/erp-integration-guide)

[Customer Credit](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/customer-credit-integration-guide)

[External Marketplace](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/external-marketplace-integration-guide)

[External Seller](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/external-seller-integration-guide)

[Gift Card](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/gift-card-integration-guide)

[Headless commerce](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/headless-commerce)

[Login (SSO)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/login-integration-guide)

[Punchout](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/punchout)

[Offer Management Integration Guide](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors)

[Offer Management SDK](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/offer-management-sdk)

[Payments](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/payments-integration-guide)

[Search Protocol](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/search-integration-guide)

[Session Manager](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/session-manager)

[Tax Service](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/tax-service-integration-guide)

[Pricing Hub](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/pricing-hub)

[reCAPTCHA](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/recaptcha)

---

[Catalog](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/catalog-integration)

---

[Checkout](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/checkout-api-overview)

---

[Master Data](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/master-data)

---

Payments

---

Orders

---

Logistics

---

B2B Suite

---

VTEX Sales App

---

UI Customization

---

Message Center

---

Pricing

---

Promotions

---

Infrastructure

---

Search

---

Storefront Permissions

---

[VTEX Activity Flow](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/activity-flow)

---

[VTEX Ads](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/vtex-ads)

---

VTEX Session

---

VTEX Shield

---

[Data Protection Plus](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/data-protection-plus)

---

Weni by VTEX

---

[Guides](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides)

[API Reference](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/api-reference)

[App Development](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/app-development)

[Storefront Development](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/storefront-development)

[VTEX IO Apps](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/vtex-io-apps)

[Troubleshooting](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/troubleshooting)

---

[Release Notes](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/updates/release-notes)

Guides

[VTEX Platform Overview](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/vtex-platform-overview)

---

[API usage](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/api-usage)

---

[Getting started](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/getting-started)

---

Integration Guides

[Back office integration guide (ERP/PIM/WMS)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/erp-integration-guide)

[Customer Credit](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/customer-credit-integration-guide)

[External Marketplace](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/external-marketplace-integration-guide)

[External Seller](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/external-seller-integration-guide)

[Gift Card](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/gift-card-integration-guide)

[Headless commerce](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/headless-commerce)

[Login (SSO)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/login-integration-guide)

[Punchout](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/punchout)

[Offer Management Integration Guide](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors)

[Offer Management SDK](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/offer-management-sdk)

[Payments](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/payments-integration-guide)

[Search Protocol](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/search-integration-guide)

[Session Manager](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/session-manager)

[Tax Service](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/tax-service-integration-guide)

[Pricing Hub](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/pricing-hub)

[reCAPTCHA](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/recaptcha)

---

[Catalog](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/catalog-integration)

---

[Checkout](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/checkout-api-overview)

---

[Master Data](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/master-data)

---

Payments

---

Orders

---

Logistics

---

B2B Suite

---

VTEX Sales App

---

UI Customization

---

Message Center

---

Pricing

---

Promotions

---

Infrastructure

---

Search

---

Storefront Permissions

---

[VTEX Activity Flow](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/activity-flow)

---

[VTEX Ads](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/vtex-ads)

---

VTEX Session

---

VTEX Shield

---

[Data Protection Plus](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/data-protection-plus)

---

Weni by VTEX

---

[Guides](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides)

Integration Guides

[Offer Management Integration Guide](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors)

Offer Management integration guide

Learn how to use Offer Management to improve the seller's visibility of the product's sending process to external channels.

> The Offer Management module has been discontinued and is no longer supported. The module has been replaced by [Offer Status](https://read.calvincode.net/reader?url=https://help.vtex.com/en/tutorial/status-de-anuncios-beta--2OE87wU26F7lApl99OdwvJ). To learn more, visit the [announcement](https://read.calvincode.net/reader?url=https://help.vtex.com/en/announcements/modulo-status-dos-anuncios-para-integracoes-com-marketplaces-vtex--1EeGgit1Brq3mmm8qhv2m3).

Offer Management is the VTEX feature that gives sellers more visibility around a product’s sending process to external channels, like marketplaces. Offer Management does not reflect what happens to offers after they’re sent to channels and start being sold. Instead, it helps sellers identify updates and solve errors in their offers during the sending process, guaranteeing that they can be sent to the marketplace and synced correctly.

Connectors are responsible for integrating marketplaces to Offer Management, so that sellers can have updated information about their offers, and solve any errors around them.

**This documentation is a guide for connectors to integrate with Offer Management, and become an available channel for sellers to track their offers with.**

Connectors interact with Offer Management in four ways:

1. [Creating channel](#1-create-channel).
2. [Activating feed](#2-feed-establishing-the-connection).
3. [Updating offers](#3-interactions-where-all-processes-happen), by creating interactions.
4. [Registering all actions in the Offer Management timeline](#4-logs-registering-steps), by creating logs.

> **VTEX Bridge** was the previous VTEX module responsible for managing all marketplaces used by a seller. Offer Management replaces the product, price, and inventory features currently managed by VTEX Bridge.

The diagram below shows the Offer Management’s interface, which the vendors access through their VTEX accounts.

![{"base64":"  ","img":{"width":1366,"height":828,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":96137,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/images/sent-offers-integration-guide-connectors-0.png"}}](https://read.calvincode.net/reader?url=https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/images/sent-offers-integration-guide-connectors-0.png)

## 1\. Create Channel

> **API Reference:** [Create Channel](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23post-/api/sent-offers/channels)

The first step for connectors to integrate with Offer Management is to create a channel, that represents the marketplace to where sellers will send their offers.

The [Create Channel API](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23post-/api/sent-offers/channels) must be called a single time by the connector for each marketplace. The feedId created by this call will apply to all sellers connected to the given channel, and will be necessary for the next step of the integration flow.

> Note that creating the channel through API is a sensitive step, and does not include public endpoints for retrieving (`GET`), updating (`PUT`), or deleting (`DELETE`) the channel created. If you wish to make any changes of this sort, you can request it through a [support](https://read.calvincode.net/reader?url=https://help.vtex.com/support?/cultureInfo=en-us) ticket with VTEX.

## 2\. Feed: establishing the connection

> **API Reference:** [Activate Feed](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23post-/api/sent-offers/feeds)

After you have [created the channel](#1-create-channel) in Offer Management, the connection between seller and marketplace can be established, through the feed. The channels available for connecting with Offer Management are:

* Mercado Livre Classic
* Mercado Livre Premium
* Netshoes
* VTEX marketplaces

The feed links the created channel to a seller’s account, so offers and their data can be exchanged. When a connector calls the [Activate Feed](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23post-/api/sent-offers/feeds) API, it establishes the relation between a seller and the channel. This endpoint should only be used once, to activate the channel and establish the connection. However, If a feed is [deactivated](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23delete-/api/sent-offers/feeds/-feedId-), it can be reactivated for that channel by another call to the Activate Feed API.

### Managing the Feed ID

The `feedId` attribute that identifies a feed between a seller and a channel, follows a standardized pattern that will be used by connectors when establishing the connection between the two. This means that a feed’s `feedId` is always the same for the relation between those specific sellers and channels, and will be used in other API calls. Connectors can create more than one feed with a single marketplace, depending on their business rules. It doesn’t matter if a feed is established more than once, the ID is always the same, and each connector is aware of the ID implemented.

The pattern for naming the `feedId` is the following: `“seller” + “.” + “channel’s name”`

Ex., “vtex.netshoes”, “anymarket.b2w”, `"vtex.meli-premium"`, `"vtex.meli-classic"`, “vtex.wish”.

## 3\. Interactions: where all processes happen

> **API Reference:** [Open Interaction](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23post-/api/sent-offers/feeds/-feedId-/skus/-skuId-/interactions), [Close Interaction](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23post-/api/sent-offers/feeds/-feedId-/skus/-skuId-/interactions/-interactionId-/close)

Both the Marketplace and the seller operate everything that happens to offers by creating interactions. For every action that happens to an offer, the connector must create an interaction to notify it. The image below shows how interactions appear on the Offer Management's UI.

![{"base64":"  ","img":{"width":1366,"height":916,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":76707,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/images/sent-offers-integration-guide-connectors-1.png"}}](https://read.calvincode.net/reader?url=https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/images/sent-offers-integration-guide-connectors-1.png)

### Interaction Lifecycle

An interaction is the space where a process around an offer and all the actions within it are recorded. It’s lifecycle is the following:

1. **Open interaction:** connectors [open an interaction](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23post-/api/sent-offers/feeds/-feedId-/skus/-skuId-/interactions) to begin adding a process to an offer.
2. **Create logs:** while open, connectors include in that interaction all the steps that happened to make it come to life, by adding [logs](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23post-/api/sent-offers/feeds/-feedId-/skus/-skuId-/interactions/-interactionId-/logs).
3. **Close interaction:** the connector [closes the interaction](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23post-/api/sent-offers/feeds/-feedId-/skus/-skuId-/interactions/-interactionId-/close), once the process it was trying to accomplish is concluded and there are no more events taking place within it.

### Interaction Origins

A seller interaction’s `origin` indicates what the process is about, and includes the following categories:

* Catalog
* Price
* Inventory

![{"base64":"  ","img":{"width":3045,"height":718,"type":"jpg","mime":"image/jpeg","wUnits":"px","hUnits":"px","length":142662,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/images/sent-offers-integration-guide-connectors-2.jpg"}}](https://read.calvincode.net/reader?url=https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/images/sent-offers-integration-guide-connectors-2.jpg)

Interactions are usually used to deal with a single type of process at a time. However, there are situations in which data about catalog, price or inventory are added in the same interaction.

> Ex., B2W’s API has only one endpoint for creating and updating products. This means that to send them a seller’s catalog, both price and inventory data must be sent through the request. So even though initially an `Inventory type` interaction is created, price data will also be added.

### Offers Status

The seller’s goal is to send and sync all their offers on a channel. In this process, **offers** can have the following statuses:

* **Synced:** when offers are successfully sent to a channel and are currently being synced between both entities.
* **Sending:** intermediate state, when offers are still in the process of being sent to a channel. This status involves offers that are either sent for the first time to the marketplace, migrated to a new marketplace, or resent offers that were once deleted from a channel.
* **Error:** when Offer Management finds an error that prevents sending or updating an offer to a channel. Therefore this status requires manual correction.
* **Disabled:** when the offer is discarded by the connector, by being inactive or not included in the trade policy.

### Result Status

An interaction’s goal is to generate a process, or update to an offer. Once an interaction is closed, the combination of steps that constitute it produce a `result`, that summarizes the outcome of the interaction. Interaction **results** include:

* **Success:** When events close their lifecycle successfully, and generate updates on an offer in terms of price, inventory, or catalog.
* **Failure:** When the connector has detected processes that have failed to be made due to an error.
* **Notification:** When there are processes with the connector that are worth mentioning, but there are no actual updates.

> Ex: discarded updates or sendings of an offer.

* **Processing:** When an open interaction hasn’t been concluded, and should still receive more steps. This is a transitory state, considering that when an interaction is closed, it can only end with `success`, `failure` or `notification` as its result.

This result is what allows Offer Management to infer an offer’s status. The types of interaction results, and their relation to offer statuses are the following:

| Interaction result | Status          | Description                                                                                |
| ------------------ | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Success**        | **Synced**      | When closing a success interaction, Offer Management updates the offer’s status to Synced, if there aren't any active errors in this offer.                                                                                |
| **Success**        | **Unavailable** | When the offer already exists and the seller removes it from the trade policy, Offer Management doesn’t infer an offer’s status.                                                                                |
| **Failure**        | **Error**       | When an offer has at least one failure interaction, the offer’s status becomes error.                                                                                |
| **Notification**   | **Unavailable** | When the offer is discarded by the connector - by being inactive or not included in the trade policy, Offer Management doesn’t infer an offer’s status, and the connector indicates it. In that case, the connector will send the "status":"unavailable" data in an interaction. |
| **Processing**     | **Sending**     | When the interaction is being processed, the offer’s status becomes sending when the interaction has the attribute “context”=”setup”.                                                                                |

## 4\. Logs: registering steps

> **API Reference:** [Create Log](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23post-/api/sent-offers/feeds/-feedId-/skus/-skuId-/interactions/-interactionId-/logs)

Logs are the granular details of actions that happen within an interaction, organized in a timeline. They are the way an interaction is made visible in Sent Offer’s UI. All micro steps that go through an interaction will be represented through logs.

### Log Types

Connectors are responsible for attributing the correct type for each log. Therefore, be mindful of their correct usage, by following the descriptions below:

* **Success:** only logs that conclude an interaction’s goal should be `“type”=”success”`._Ex. concluded updates in price, inventory, offer ID, or catalog._
* **Information:** logs that expose the actions of an update process, to provide visibility and contribute with more technical investigations. Info logs may include internal processes of a system (`agent` attribute), or calls between two systems._Ex. Placing an offer in the queue, indicating that an offer is being processed, indicating that a call to Catalog has been made, adding requests and responses as evidences, etc._
* **Warning:** logs used in cases where the communication between two systems fails, and there are no actions that the user can take to fix it. They are usually cases where the connector should perform a retry, and provide visibility of what is being attempted again._Ex. Throttling, service unavailable, etc._
* **Failure:** logs noticed by the connector as errors that prevent an offer from being correctly sent and synced to a channel. They will be described in more detail in the following section._Ex. Product descriptions that exceed the character limit, product’s image with low quality, etc._

## 5\. Actions performed by creating interactions and logs

### Sending offers to the marketplace

> **API Reference:** [Activate Feed](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23post-/api/sent-offers/feeds), [Open Interaction](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23post-/api/sent-offers/feeds/-feedId-/skus/-skuId-/interactions), [Create Log](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23post-/api/sent-offers/feeds/-feedId-/skus/-skuId-/interactions/-interactionId-/logs), [Close Interaction](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23post-/api/sent-offers/feeds/-feedId-/skus/-skuId-/interactions/-interactionId-/close)

Connectors are the agents responsible for sending the seller’s products to their channels. They do that by creating events, since that is the mechanism for reporting all interactions around offers. Consider the following example, in which a seller wants to integrate with Mercado Livre:

1. Activate the **Feed**.
2. Open **Interaction**.
3. Create **Log**._In that log, connectors indicate the series of actions that took place for the offers to be created._
4. Call **Catalog** API._One of the logs shows that connectors called the Catalog API to identify the SKUs that were present in the Mercado Livre trade policy, and try to send their offers to that channel. As long as that analysis happens, the offer’s status is `sending`._ _SKUs that are identified as being a part of Mercado Livre’s trade policy are sent to the channel. - All SKUs that don’t belong to that trade policy are discarded, and kept in the Discarded Offers page, in the UI._
5. Create **Log.** _Once this analysis process is over, and the connector has identified which SKUs belong to the channel, and which can be discarded, the connector can create the last log of that event, indicating success or failure._ _It is important to point out that whenever a Catalog log is created, Offer Management evaluates if that offer already exists in its base. If it’s the first load of products, or if a new product is added, the `context` field’s value is `setup`._
6. Close **Interaction**.

### Updating offers through Interactions

> **API Reference:** [Open Interaction](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23post-/api/sent-offers/feeds/-feedId-/skus/-skuId-/interactions), [Create Log](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23post-/api/sent-offers/feeds/-feedId-/skus/-skuId-/interactions/-interactionId-/logs), [Close Interaction](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23post-/api/sent-offers/feeds/-feedId-/skus/-skuId-/interactions/-interactionId-/close)

**Updates from sellers:** Sellers notify the marketplace of all changes that come from their side, by creating interactions. These are the types of changes that come from sellers:

* Product information, from the Catalog.
* Price value.
* Inventory level.

**Updates from Marketplaces:** The Marketplace notifies Offer Management about all changes originating from its side. These are the changes that come from marketplaces:

* Changes in the Offer ID from the Marketplace’s side.
* Errors detected.

### Pointing out errors in offers

> **API Reference:** [Create Log](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23post-/api/sent-offers/feeds/-feedId-/skus/-skuId-/interactions/-interactionId-/logs), [Search Errors](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23get-/api/sent-offers/search/errors)

It is the connector's responsibility to identify errors that prevent an offer from being sent to a marketplace. This log allows the connector to notify the Offer Management that an error has occurred. Connectors point out problems with an offer by creating failure logs. From the information sent through the `errors` attribute, sellers can identify and fix errors on their offers.

Connectors must identify all errors, and send them all in a single request. This means that connectors should go through every possible validation, and only after all errors are identified, create the failure log.

#### Error codes

The Offer Management owns the intelligence by recognizing most of the problems that happen between VTEX, connectors and channels. This way, through a code, a connector will be able to identify pre-defined classifications and solving actions for their errors and easily leverage from it without needing development from their end. All the attributes of a code are filled and maintained by Offer Management. The Offer Management will create, update and delete codes in order to always keep an updated list for connectors leveraging from it.

The **Search Errors** endpoint returns the updated list of error codes. It is the only source of truth about the codes and where they will be always updated.

#### External code

Connectors must extend the Offer Management' codes by adding their own code IDs for mapping specific scenarios that apply to their own system. They can send those codes through a suffix ID added in an existing code. This way the Offer Management knows which errors must be archived and which errors must be kept, being able to classify that given error and improve its solving action. These suffix IDs are totally managed by the connectors, which will require them a way to map each error inside their own code.

The format for adding external codes should be:

`internalCode` \+ `connectorCode`

Ex: let's say the Offer Management code for errors in the description field is `CTLG-005`. On Marketplace A, it is not allowed to use HTML on the description, and to use more than 4000 characters. On Marketplace B it is not allowed to use more than 5000 characters.

So Marketplace A’s connector would insert errors of description with HTML extending the original code like this: `CTLG-005-001`. And the character one could be `CTLG-005-002`. While Marketplace B’s connector could insert `CTLG-005-001`.

#### Unmapped errors

It is expected that errors that haven’t been mapped by Offer Management, and aren’t yet on the error’s code list, may appear. Follow the practices below to identify and deal with them:

* **Unmapped error’s code:** for those scenarios, the Offer Management created the following error code: `NTMAP-001`. This code should be used by the connector when they don’t recognize the error received.
* **Identifying unmapped errors:** in this case, we recommend using the hash method to map these errors. Ideally, this method should be used when the error’s description doesn’t present variables. Thus it will be possible to monitor and verify which unmapped errors are occurring more frequently, so they are later codified. It is a cyclical process, where the connector provides new data so that the Offer Management can improve its error mapping.
* **Adding evidence to unmapped errors:** unmapped errors still need evidences in their logs so sellers understand the situation. We recommend sending the error detected by the channel’s API response in the `evidence` field.

### Updating and deleting a Feed

> **API Reference:** [Update Feed](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23put-/api/sent-offers/feeds/-feedId-), [Deactivate Feed](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23delete-/api/sent-offers/feeds/-feedId-)

Updating a feed’s information is only possible through API calls. Only the trade policy and affiliate ID can be changed. When a channel integration is uninstalled by the seller, the connector must delete the feed in Offer Management as well. That way, that channel won’t appear in the UI. This action is done by the Delete Feed endpoint.

Note that once the feed is deleted, all offers’ data, errors and their logs will also be deleted from the UI. However, the source of truth around the products sent to the channel will still remain in the catalog, and log’s history will be preserved. If the channel integration is reinstalled, the whole process described in this guide must begin again, done from scratch. This means the connector will have to send all offers from the catalog to the channel again anyways.

## API Reference

* [Create Channel](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23post-/api/sent-offers/channels)
* [Activate Feed](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23post-/api/sent-offers/feeds)
* [List Feeds](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23get-/api/sent-offers/feeds)
* [Update Feed](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23put-/api/sent-offers/feeds/-feedId-)
* [Get Feed by feedId](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23get-/api/sent-offers/feeds/-feedId-)
* [Deactivate Feed](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23delete-/api/sent-offers/feeds/-feedId-)
* [Open Interaction](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23post-/api/sent-offers/feeds/-feedId-/skus/-skuId-/interactions)
* [Get Interaction Data by interactionId](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23get-/api/sent-offers/feeds/-feedId-/skus/-skuId-/interactions/-interactionId-)
* [Close Interaction](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23post-/api/sent-offers/feeds/-feedId-/skus/-skuId-/interactions/-interactionId-/close)
* [Create Log](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23post-/api/sent-offers/feeds/-feedId-/skus/-skuId-/interactions/-interactionId-/logs)
* [Get Log Data by logId](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23get-/api/sent-offers/feeds/-feedId-/skus/-skuId-/interactions/-interactionId-/logs/-logId-)
* [Search Interactions and their Logs](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23get-/api/sent-offers/search/interactions)
* [Search Errors](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23get-/api/sent-offers/search/errors)
* [Get Error Code data by errorCodeId](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/marketplace-apis-offer-management%23get-/api/sent-offers/error-codes/-errorCodeId-)

Contributors

3

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F91396357%3Fv%3D4%26w=64%26q=75)](https://github.com/anabaarbosa)

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F60782333%3Fv%3D4%26w=64%26q=75)](https://github.com/carolinamenezes)

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F83723439%3Fv%3D4%26w=64%26q=75)](https://github.com/jumeyermattosarruda)

Was this helpful?

Yes

No

[Suggest Edits (GitHub)](https://read.calvincode.net/reader?url=https://github.com/vtexdocs/dev-portal-content/edit/main/docs/guides/Integration-Guides/sent-offers-integration-guide-connectors.md)

[Punchout login integration« Previous](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors//docs/guides/punchout-login-integration)[Offer Management SDKNext »](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors//docs/guides/offer-management-sdk)

Contributors

3

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F91396357%3Fv%3D4%26w=64%26q=75)](https://github.com/anabaarbosa)

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F60782333%3Fv%3D4%26w=64%26q=75)](https://github.com/carolinamenezes)

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F83723439%3Fv%3D4%26w=64%26q=75)](https://github.com/jumeyermattosarruda)

ON THIS PAGE

[1\. Create Channel](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%231-create-channel)

[2\. Feed: establishing the connection](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%232-feed-establishing-the-connection)

[Managing the Feed ID](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%23managing-the-feed-id)

[3\. Interactions: where all processes happen](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%233-interactions-where-all-processes-happen)

[Interaction Lifecycle](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%23interaction-lifecycle)[Interaction Origins](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%23interaction-origins)[Offers Status](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%23offers-status)[Result Status](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%23result-status)

[4\. Logs: registering steps](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%234-logs-registering-steps)

[Log Types](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%23log-types)

[5\. Actions performed by creating interactions and logs](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%235-actions-performed-by-creating-interactions-and-logs)

[Sending offers to the marketplace](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%23sending-offers-to-the-marketplace)[Updating offers through Interactions](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%23updating-offers-through-interactions)[Pointing out errors in offers](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%23pointing-out-errors-in-offers)[Updating and deleting a Feed](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%23updating-and-deleting-a-feed)

[API Reference](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%23api-reference)

Was this helpful?

 Send feedback

[Suggest edits (GitHub)](https://read.calvincode.net/reader?url=https://github.com/vtexdocs/dev-portal-content/edit/main/docs/guides/Integration-Guides/sent-offers-integration-guide-connectors.md)

Copy page

On this page

ON THIS PAGE

[1\. Create Channel](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%231-create-channel)

[2\. Feed: establishing the connection](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%232-feed-establishing-the-connection)

[Managing the Feed ID](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%23managing-the-feed-id)

[3\. Interactions: where all processes happen](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%233-interactions-where-all-processes-happen)

[Interaction Lifecycle](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%23interaction-lifecycle)[Interaction Origins](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%23interaction-origins)[Offers Status](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%23offers-status)[Result Status](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%23result-status)

[4\. Logs: registering steps](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%234-logs-registering-steps)

[Log Types](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%23log-types)

[5\. Actions performed by creating interactions and logs](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%235-actions-performed-by-creating-interactions-and-logs)

[Sending offers to the marketplace](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%23sending-offers-to-the-marketplace)[Updating offers through Interactions](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%23updating-offers-through-interactions)[Pointing out errors in offers](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%23pointing-out-errors-in-offers)[Updating and deleting a Feed](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%23updating-and-deleting-a-feed)

[API Reference](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors/docs/guides/sent-offers-integration-guide-connectors%23api-reference)

On this page

[Github](https://read.calvincode.net/reader?url=https://github.com/vtex-apps)[Help Center](https://read.calvincode.net/reader?url=https://help.vtex.com/)[Community](https://read.calvincode.net/reader?url=https://community.vtex.com/?%5Fga=2.198523433.743584735.1647618303-1974737580.1645714642)[Feedback](https://read.calvincode.net/reader?url=https://docs.google.com/forms/d/e/1FAIpQLSfmnotPvPjw-SjiE7lt2Nt3RQgNUe10ixXZmuO2v9enOJReoQ/viewform?entry.1972292648=developers.vtex.com%26entry.1799503232=)


[System] You are a VTEX documentation expert. You provide accurate, detailed information about VTEX platform, APIs, apps, and Store Framework development.

[User] Provide a guide on guides payments integration guide in VTEX.

[Assistant]
Documentation

[Feedback](https://read.calvincode.net/reader?url=https://docs.google.com/forms/d/e/1FAIpQLSfmnotPvPjw-SjiE7lt2Nt3RQgNUe10ixXZmuO2v9enOJReoQ/viewform?entry.1972292648=developers.vtex.com%26entry.1799503232=)

[GuidesLearn how to use our APIs and extend the VTEX platform.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides)

[API ReferenceExplore detailed information about our endpoints.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/api-reference)

[App DevelopmentLearn how to build cloud-based apps and integrations.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/app-development)

[Storefront DevelopmentExpress your brand identity creating unique storefronts.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/storefront-development)

[VTEX IO AppsFind pre-built solutions to grow your business.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/vtex-io-apps)

[TroubleshootingFind practical solutions to common development issues.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/troubleshooting)

[Release NotesStay up to date with our latest releases and bug fixes.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/updates/release-notes)

Guides

[VTEX Platform Overview](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/vtex-platform-overview)

---

[API usage](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/api-usage)

---

[Getting started](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/getting-started)

---

Integration Guides

[Back office integration guide (ERP/PIM/WMS)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/erp-integration-guide)

[Customer Credit](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/customer-credit-integration-guide)

[External Marketplace](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/external-marketplace-integration-guide)

[External Seller](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/external-seller-integration-guide)

[Gift Card](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/gift-card-integration-guide)

[Headless commerce](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/headless-commerce)

[Login (SSO)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/login-integration-guide)

[Punchout](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/punchout)

[Offer Management Integration Guide](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/sent-offers-integration-guide-connectors)

[Payments](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/payments-integration-guide)

[Integrating a new payment provider on VTEX](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/integrating-a-new-payment-provider-on-vtex)

[Payment Provider Protocol](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/payments-integration-payment-provider-protocol)

[Payment Provider Protocol for Point of Sale (POS) - VTEX Sales App](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/payments-integration-ppp-applied-to-pos)

[Implementing a Payment Provider](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/payments-integration-implementing-a-payment-provider)

[Payment Provider Framework](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/payments-integration-payment-provider-framework)

[Purchase Flows](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/payments-integration-purchase-flows)

[Payment App](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/payments-integration-payment-app)

[Payment Methods](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/payments-integration-payment-methods)

[Payment Provider Homologation](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/payments-integration-payment-provider-homologation)

[Antifraud Provider Protocol](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/how-the-integration-protocol-between-vtex-and-antifraud-companies-works)

[PCI - DSS Compliance](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/payments-integration-pci-dss-compliance)

[Secure Proxy](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/payments-integration-secure-proxy)

[Split Payouts on Payment Provider Protocol](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/split-payouts-on-payment-provider-protocol)

[Layout Development Guide for payment methods in Smart Checkout VTEX](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/layout-development-guide-for-payment-methods-in-smart-checkout-vtex)

[Custom Auto Capture Feature](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/custom-auto-capture-feature)

[Pix: Instant Payments in Brazil](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/payments-integration-pix-instant-payments-in-brazil)

[PSE Payment Method](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/pse-payment-method)

[Google Pay: processing information for payment providers and anti-fraud](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/google-pay-processing-information-for-payment-providers-and-anti-fraud)

[Search Protocol](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/search-integration-guide)

[Session Manager](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/session-manager)

[Tax Service](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/tax-service-integration-guide)

[Pricing Hub](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/pricing-hub)

[reCAPTCHA](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/recaptcha)

---

[Catalog](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/catalog-integration)

---

[Checkout](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/checkout-api-overview)

---

[Master Data](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/master-data)

---

Payments

---

Orders

---

Logistics

---

B2B Suite

---

VTEX Sales App

---

UI Customization

---

Message Center

---

Pricing

---

Promotions

---

Infrastructure

---

Search

---

Storefront Permissions

---

[VTEX Activity Flow](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/activity-flow)

---

[VTEX Ads](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/vtex-ads)

---

VTEX Session

---

VTEX Shield

---

[Data Protection Plus](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/data-protection-plus)

---

Weni by VTEX

---

[Guides](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides)

[API Reference](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/api-reference)

[App Development](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/app-development)

[Storefront Development](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/storefront-development)

[VTEX IO Apps](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/vtex-io-apps)

[Troubleshooting](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/troubleshooting)

---

[Release Notes](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/updates/release-notes)

Guides

[VTEX Platform Overview](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/vtex-platform-overview)

---

[API usage](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/api-usage)

---

[Getting started](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/getting-started)

---

Integration Guides

[Back office integration guide (ERP/PIM/WMS)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/erp-integration-guide)

[Customer Credit](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/customer-credit-integration-guide)

[External Marketplace](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/external-marketplace-integration-guide)

[External Seller](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/external-seller-integration-guide)

[Gift Card](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/gift-card-integration-guide)

[Headless commerce](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/headless-commerce)

[Login (SSO)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/login-integration-guide)

[Punchout](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/punchout)

[Offer Management Integration Guide](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/sent-offers-integration-guide-connectors)

[Payments](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/payments-integration-guide)

[Integrating a new payment provider on VTEX](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/integrating-a-new-payment-provider-on-vtex)

[Payment Provider Protocol](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/payments-integration-payment-provider-protocol)

[Payment Provider Protocol for Point of Sale (POS) - VTEX Sales App](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/payments-integration-ppp-applied-to-pos)

[Implementing a Payment Provider](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/payments-integration-implementing-a-payment-provider)

[Payment Provider Framework](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/payments-integration-payment-provider-framework)

[Purchase Flows](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/payments-integration-purchase-flows)

[Payment App](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/payments-integration-payment-app)

[Payment Methods](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/payments-integration-payment-methods)

[Payment Provider Homologation](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/payments-integration-payment-provider-homologation)

[Antifraud Provider Protocol](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/how-the-integration-protocol-between-vtex-and-antifraud-companies-works)

[PCI - DSS Compliance](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/payments-integration-pci-dss-compliance)

[Secure Proxy](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/payments-integration-secure-proxy)

[Split Payouts on Payment Provider Protocol](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/split-payouts-on-payment-provider-protocol)

[Layout Development Guide for payment methods in Smart Checkout VTEX](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/layout-development-guide-for-payment-methods-in-smart-checkout-vtex)

[Custom Auto Capture Feature](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/custom-auto-capture-feature)

[Pix: Instant Payments in Brazil](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/payments-integration-pix-instant-payments-in-brazil)

[PSE Payment Method](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/pse-payment-method)

[Google Pay: processing information for payment providers and anti-fraud](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/google-pay-processing-information-for-payment-providers-and-anti-fraud)

[Search Protocol](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/search-integration-guide)

[Session Manager](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/session-manager)

[Tax Service](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/tax-service-integration-guide)

[Pricing Hub](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/pricing-hub)

[reCAPTCHA](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/recaptcha)

---

[Catalog](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/catalog-integration)

---

[Checkout](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/checkout-api-overview)

---

[Master Data](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/master-data)

---

Payments

---

Orders

---

Logistics

---

B2B Suite

---

VTEX Sales App

---

UI Customization

---

Message Center

---

Pricing

---

Promotions

---

Infrastructure

---

Search

---

Storefront Permissions

---

[VTEX Activity Flow](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/activity-flow)

---

[VTEX Ads](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/vtex-ads)

---

VTEX Session

---

VTEX Shield

---

[Data Protection Plus](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/data-protection-plus)

---

Weni by VTEX

---

[Guides](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides)

Integration Guides

[Payments](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/payments-integration-guide)

Payments

Communication between systems and services of stores, partners and platform is carried out through integration protocols. At VTEX, we use the Payment Provider Protocol (PPP), a protocol created to assist companies that carry out financial transaction operations.

Before continuing, make sure you are familiar with some terms that are frequently used in articles in this guide:

* **Acquirer:** a company that specializes in payment processing. For more information, access [What is an acquirer?](https://read.calvincode.net/reader?url=https://help.vtex.com/en/tutorial/what-is-an-acquirer--7N1oRTG8dGmOiIugC0cs4E).
* **Merchant or Client:** an individual or business that holds its ecommerce or physical stores operations in the VTEX platform.
* **Customer:** an individual or business that purchases a product or service from a VTEX client.
* **Provider:** agent that will process the merchant's payments. It can be a payment system, payment provider, or a gateway.
* **Partner:** agent responsible to carry out the integration between the provider and the VTEX platform.
* **VTEX Payment Gateway:** VTEX system responsible for processing payments. The gateway communicates with the provider through the Payment Provider Protocol (PPP).
* **Payment Service Provider (PSP):** financial entity that is authorized to process financial transactions between merchants, acquiring banks, and card networks. It is a fast and cost-effective way to accept payments without needing to open a company in another country or having to create a merchant account.
* **Payload:** set of data sent in JSON format through a request body of an endpoint.
* **Connector:** provider affiliation that acts as a bridge between the provider and the VTEX checkout.
* **Oauth:** authorization protocol made for Application Programming Interfaces (APIs). It allows the provider system to access the customer data to process a payment transaction.

The articles listed below present the characteristics and mode of operation of our payment architecture, providing implementation information to allow you to integrate your payment service into VTEX or use the payment solutions already available.

## Structure of this guide

| Article                                                                                | Description                                                                                |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| [Integrating a new payment provider on VTEX](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/integrating-a-new-payment-provider-on-vtex)                                                          | A step-by-step guide to integrating your payment provider into VTEX.                                                              |
| [Payment Provider Protocol](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-payment-provider-protocol)                                                                       | Overview of our integration protocol, the Payment Provider Protocol (PPP).                                                        |
| [Payment Provider Protocol for Point of Sale (POS) - VTEX Sales App](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-ppp-applied-to-pos)                                     | PPP information for use in physical stores.                                                                                |
| [Implementing a Payment Provider](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-implementing-a-payment-provider)                                                           | How to develop your middleware to communicate with the PPP.                                                                       |
| [Payment Provider Framework](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-payment-provider-framework)                                                                     | Overview of our alternative method of developing payment connectors through VTEX IO.                                              |
| [Purchase Flows](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-purchase-flows)                                                                                | Information on the types of payment flows available on VTEX.                                                                      |
| [Payment App](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-payment-app)                                                                                | Overview of the Payment App and how to implement it in your store.                                                                |
| [Payment Methods](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-payment-methods)                                                                                | Overview of payment methods accepted by VTEX.                                                                                |
| [Payment Provider Homologation](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-payment-provider-homologation)                                                               | How to carry out the tests to request the approval of your payment connector.                                                     |
| [Anti-fraud Provider Protocol](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/how-the-integration-protocol-between-vtex-and-antifraud-companies-works)                                           | Overview of our anti-fraud integration protocol, the Anti-fraud Provider Protocol.                                                |
| [PCI - DSS Compliance](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-pci-dss-compliance)                                                                                | Information about the PCI-DSS certification and when it is required.                                                              |
| [Secure Proxy](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-secure-proxy)                                                                                | Information about the VTEX solution for transferring sensitive data in an environment without the use of PCI - Dss certification. |
| [Split Payouts on Payment Provider Protocol](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/split-payouts-on-payment-provider-protocol)                                                          | Overview of our Split Payouts process on the PPP.                                                                                |
| [Layout Development Guide for payment methods in Smart Checkout VTEX](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/layout-development-guide-for-payment-methods-in-smart-checkout-vtex)        | How to develop a custom layout for your payment method.                                                                           |
| [Custom Auto Capture Feature](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/custom-auto-capture-feature)                                                                                | Information from the VTEX solution created to define a custom delay interval for automatically capturing payments.                |
| [Pix: Instant Payments in Brazil](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-pix-instant-payments-in-brazil)                                                            | How to implement the PIX payment method in your store.                                                                            |
| [PSE Payment Method](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/pse-payment-method)                                                                                | How to implement the PSE payment method in your store.                                                                            |
| [Installing Affirm Payment App](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/installing-affirm-payment-app-1)                                                                                | How to implement the Affirm Payment App payment method in your store.                                                             |
| [Google Pay: processing information for payment providers and anti-fraud](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/google-pay-processing-information-for-payment-providers-and-anti-fraud) | How the Google Pay payment method is identified in transactions.                                                                  |

> ✔ To integrate a payment solution in VTEX you must fill out the registration form to join our [Partner Program](https://read.calvincode.net/reader?url=https://vtex.com/us-en/partners) to get access to your own VTEX account. If you are already a client or partner, you can [open a support ticket](https://read.calvincode.net/reader?url=https://help.vtex.com/en/tutorial/opening-tickets-to-vtex-support--16yOEqpO32UQYygSmMSSAM) if you have any questions.

Contributors

2

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F87548049%3Fv%3D4%26w=64%26q=75)](https://github.com/ricardoaerobr)

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F7108339%3Fv%3D4%26w=64%26q=75)](https://github.com/brunoamui)

Was this helpful?

Yes

No

[Suggest Edits (GitHub)](https://read.calvincode.net/reader?url=https://github.com/vtexdocs/dev-portal-content/edit/main/docs/guides/Integration-Guides/payments-integration-guide.md)

[Offer Management SDK« Previous](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide//docs/guides/offer-management-sdk)[Integrating a new payment provider on VTEXNext »](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide//docs/guides/integrating-a-new-payment-provider-on-vtex)

Contributors

2

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F87548049%3Fv%3D4%26w=64%26q=75)](https://github.com/ricardoaerobr)

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F7108339%3Fv%3D4%26w=64%26q=75)](https://github.com/brunoamui)

ON THIS PAGE

[Structure of this guide](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/payments-integration-guide%23structure-of-this-guide)

Was this helpful?

 Send feedback

[Suggest edits (GitHub)](https://read.calvincode.net/reader?url=https://github.com/vtexdocs/dev-portal-content/edit/main/docs/guides/Integration-Guides/payments-integration-guide.md)

Copy page

On this page

ON THIS PAGE

[Structure of this guide](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/payments-integration-guide/docs/guides/payments-integration-guide%23structure-of-this-guide)

On this page

[Github](https://read.calvincode.net/reader?url=https://github.com/vtex-apps)[Help Center](https://read.calvincode.net/reader?url=https://help.vtex.com/)[Community](https://read.calvincode.net/reader?url=https://community.vtex.com/?%5Fga=2.198523433.743584735.1647618303-1974737580.1645714642)[Feedback](https://read.calvincode.net/reader?url=https://docs.google.com/forms/d/e/1FAIpQLSfmnotPvPjw-SjiE7lt2Nt3RQgNUe10ixXZmuO2v9enOJReoQ/viewform?entry.1972292648=developers.vtex.com%26entry.1799503232=)