Payments Overview


📣 Help us improve this documentation! Share your feedback by filling out this form.

Developing an antifraud integration

Antifraud solutions are used along with payment transactions to make them more secure by performing a risk analysis. VTEX allows antifraud systems to be integrated by providers through a protocol. The Antifraud Provider Protocol is a contract between VTEX and providers where VTEX defines a set of rules that have to be implemented by the providers in their integrations. The integrations have to include a set of endpoints defined in our Antifraud Provider Protocol API.

Developing a gift card integration

At VTEX, gift cards are treated as a payment option and their transactions are processed in the Checkout. Besides our native solution, VTEX allows external gift card providers to implement their integrations using our Gift Card Provider Protocol. Through this protocol, providers can develop a middleware containing the endpoints described in our Gift Card Provider Protocol API and connects with our Gift Card Hub. You can check more details about Gift Cards in the articles below:

Understanding VTEX’s Payments architecture

VTEX’s payment systems provide many resources to support all kinds of payment methods, conditions and integrations. This versatility also comes with complexity. If you are developing an integration or dealing with a more complex payment configuration, having a better understanding of our Payments architecture might help you. You can check details about it in these articles:

Configuring specific payment methods or affiliations

The most common process to make payments available in your store is by configuring an affiliation (related to the provider you have a contract with) and a method in the Admin. Instructions for this process are found mostly in our Help Center, but some configurations are more advanced and described in the articles below:

Configuring payments for specific use cases

When adding or editing a payment configuration in your store, you might need specific use cases such as defining a type of interest rate or processing payments through an external seller. Check the articles below for more information:

Developing a payment integration

Payment providers can implement their integrations using our Payment Provider Protocol. This protocol enables providers to create a payment connector that interacts with our Gateway and contains the endpoints described in our Payment Provider Protocol API. Besides developing the connector, providers also need to test them and make sure they follow the required security standards before they can be available to the stores. You can check the details for those steps in the articles below:

Customizing your payment integration

When developing a payment integration, you might need to add specific features. You can enable specific payment methods that require additional work (i.e.: Pix), create a custom flow or add a validation step in the Checkout (Payment App), among other options. You can check our available options in the articles below:

Payment layout customization examplePayment layout customization example

Payment layout customization example

Payment App examplePayment App example

Payment App example

Did this page help you?