At VTEX, it is possible to integrate with the payment provider Mercado Pago. Through this connector, your store can offer payment transactions in physical stores (VTEX Sales App), using points of sale (POS). For more information access What is VTEX Sales App?.
To use the MercadoPagoV2 provider in your store through other online sales channels (except VTEX Sales App), visit Setting up payments with MercadoPagoV2.
To use the MercadoPagoV2 provider in the VTEX Sales App, you need to:
- Configure keys in the Mercado Pago environment
- Configure MercadoPagoV2 connector (VTEX Sales App) on VTEX
- Install Mercado Pago Payment and Mercado Pago Instore applications in VTEX
- Configure payment condition
Settings configured in an environment external to VTEX may be discontinued or modified without prior notice. Please check your Mercado Pago account for the latest information.
Configure keys in the Mercado Pago environment
The following steps describe the minimum configurations to be carried out so that the MercadoPagoV2 connector is properly configured. Other personalized settings applied to customers, enabling specific payment methods or particular features of the platform, must be carried out in accordance with Mercado Pago documentation.
Configure MercadoPagoV2 connector (VTEX Sales App) on VTEX
Install Mercado Pago Payment and Mercado Pago Instore applications in VTEX
Before installing the mercadopago.mercadopago-app app, confirm the current version of the application with the Mercado Pago support team.
- In VTEX IO CLI, run the command
vtex login accountname
to log in to your account. - Install the mercadopago.mercadopago-app using the command
vtex install mercadopago.mercadopago-app@{{current-app-version}}
. The information {{current-app-version}} must be replaced with the current version of the application, for example:vtex install mercadopago.mercadopago-app@2.3.15
. - Install the mercadopago.instore application using the command
vtex install mercadopago.instore
.
Configuring payment condition
- In the VTEX Admin, go to Store Settings > Payments > Settings, or type Settings in the search bar at the top of the page.
- In the Payment Conditions tab, click on the
+
button. - Click on Venda Direta Debito or Venda Direta Credito.
- Under Process with provider, select the previously configured connector.
- Activate the condition in the Status field.
- If you want to use an anti-fraud system, select the option Use anti-fraud solution.
- If you want, you can also configure special payment conditions.
- Click
Save
.
After completing these steps, the MercadoPagoV2 provider may take up to 10 minutes to appear as a payment option in your store's VTEX Sales App.