{"section":"tutorials","requestedLocale":"en","requestedSlug":"configuring-payment-with-mercado-pago-in-vtex-sales-app","locale":"en","slug":"configuring-payment-with-mercado-pago-in-vtex-sales-app","path":"docs/en/tutorials/payments/payment-settings/configuring-payment-with-mercado-pago-in-vtex-sales-app.md","branch":"main","content":"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 via **VTEX Sales App**, using points of sale (POS). For more information access [What is VTEX Sales App?](https://help.vtex.com/docs/tracks/vtex-sales-app-getting-started-and-setting-up).\n\n> ℹ️ To use the MercadoPagoV2 provider in your store through other online sales channels (except **VTEX Sales App**), visit [Setting up payments with MercadoPagoV2](/en/docs/tutorials/setting-up-mercadopagov2-sub-acquirer).\n\nTo use the MercadoPagoV2 provider in the VTEX Sales App, you need to:\n\n- [Configure keys in the Mercado Pago environment](#configure-keys-in-the-mercado-pago-environment)\n- [Configure MercadoPagoV2 connector (VTEX Sales App) on VTEX](#configure-mercadopagov2-connector-vtex-sales-app-on-vtex)\n- [Install Mercado Pago Payment and Mercado Pago Instore applications in VTEX](#install-mercado-pago-payment-and-mercado-pago-instore-applications-in-vtex)\n- [Configure payment condition](#configuring-payment-condition)\n\n> ⚠️ 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.\n\n## Configure keys in the Mercado Pago environment\n\nThe 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](https://www.mercadopago.com.br/developers/en/docs/vtex/create-application).\n\n1. Access the [Mercado Pago developer portal](https://www.mercadopago.com.br/developers/en) to create a new account.\n\n    > ⚠️ The Mercado Pago developer portal allows the user to obtain information on all the keys necessary to configure the connection between VTEX and Mercado Pago. We recommend that the procedure below be carried out by a user who already has access to the other keys to their Mercado Pago account.\n\n2. After logging in, access the Mercado Pago [credentials documentation](https://www.mercadopago.com.br/developers/en/docs/vtex/additional-content/your-integrations/credentials) to check how to obtain the **Public Key** and **Access Token** that will be used to configure MercadoPagoV2 on VTEX.\n\n## Configure MercadoPagoV2 connector (VTEX Sales App) on VTEX\n\n1. In the VTEX Admin, go to **Store Settings > Payment > Providers**, or type **Providers** in the search bar at the top of the page.\n2. On the providers screen, click the **New Provider** button.\n3. Type the name **MercadoPagoV2** in the search bar and click on the name of the provider.\n4. In **Provider Authorization**, enter the name of your **Public Key** located in the Mercado Pago developer portal.\n5. In **App token**, enter the key **Access Token** located in the Mercado Pago developer portal.\n6. If you wish to modify the identification name to be displayed for the MercadoPagoV2 provider on the VTEX Admin screen, enter the information in the **Name** field in **Basic information**.\n7. In **Payment Control**, select whether you want to activate the provider in a test environment by clicking **Enable test mode**.\n8. In the **Prazo de vencimento do boleto** (\"Boleto expiration date\"), define the value (in business days) for the purchase order to expire. If the client makes the payment after the deadline, the amount will be deposited in their Mercado Pago account.\n9. In **Nome da loja** (\"Store name\"), enter your company name. This information will be described on the customer's card invoice.\n10. In **Parcelamento máximo** (\"Max installments\"), choose the maximum number of installments available to make the payment. With Mercado Pago you can split purchases into up to 12 installments.\n11. In **Suporte 3DS 2.0** (\"3DS 2.0 Support\"), select \"Yes\" if you want to enable 3DS security validation. For this protocol to work correctly, make sure that the **Mercado Pago Payment app** will be installed in your store and that the **Modo binário** field (step 15) is set to \"No\".\n12. In **Categoria principal da loja** (\"Main store category\"), choose the category of your store's industry.\n13. In **Compartilhamento de categoria (loja ou produto) por transação** (\"Category sharing (store or product) per transaction\"), select the option **Categoria da loja**.\n14. In the option **Reembolso automático / manual** (\"Automatic / manual refund\"), choose whether the customer will be refunded automatically or if you want to retain the amount paid so that the customer can use it for future purchases at the same store.\n15. In **Modo binário** (\"Binary Mode\"), indicate whether the store should accept pending payments. Selecting \"No\" indicates that the transaction will be pending for 48 hours or until payment is made, and the inventory related to this purchase will be removed for the same period of time. Selecting \"Yes\" allows you to reject the transactions and the stock will be automatically released. To use the functionality **Suporte 3DS 2.0** (Step 11), the **Modo binário** must be set to \"No\".\n16. In **Métodos de pagamento excluídos** (\"Excluded payment methods\"), describe the payment methods you do not wish to offer through Checkout Pro; get more information at [Exclude payment types and methods](https://www.mercadopago.com.br/developers/en/docs/vtex/payments-configuration/checkout-pro/exclude-payment-types-methods). If you choose to leave this field blank, all available MercadoPagoV2 payment methods can be used in your store.\n17. In **Tipos de pagamento excluídos** (\"Excluded payment types\"), describe the specific brands of credit, debit, and ticket (Visa, Mastercard, and others) that you do not want to offer through Checkout Pro, learn more at [Exclude payment types and methods](https://www.mercadopago.com.br/developers/en/docs/vtex/payments-configuration/checkout-pro/exclude-payment-types-methods). If you choose to leave this field blank, all payment types available in MercadoPagoV2 can be used in your store.\n18. In **Modo de processamento** (\"Processing Mode\"), select the option **Aggregator**.\n19. In **Integrator ID**, indicate the identifying code of the developer or agency that configures Mercado Pago.\n20. The **Moeda** (\"Currency\") field identifies the currency used for payment in the store. It's not necessary to fill it.\n21. The **Merchant Account ID** field identifies the trading account. It is not necessary to fill it.\n22. In **Prazo de captura de pagamento aprovado** (\"Approved payment capture deadline\"), select the desired deadline for payment capture.\n23. In **Tempo para cancelar compras de um carrinho abandonado**, enter the time interval to wait until the enabled payment methods are not available to make the purchase.\n24. Click **Save**.\n\n## Install Mercado Pago Payment and Mercado Pago Instore applications in VTEX\n\n> ⚠️ Before installing the **mercadopago.mercadopago-app** app, confirm the current version of the application with the Mercado Pago support team.\n\n1. In [VTEX IO CLI](https://developers.vtex.com/docs/guides/vtex-io-documentation-vtex-io-cli-install), run the command `vtex login accountname` to log in to your account.\n2. 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`.\n3. Install the **mercadopago.instore** application using the command `vtex install mercadopago.instore`.\n\n## Configuring payment condition\n\n1. In the VTEX Admin, go to **Store Settings > Payments > Settings**, or type **Settings** in the search bar at the top of the page.\n2. In the **Payment Conditions** tab, click on the `+` button.\n3. Click on **Venda Direta Debito** or **Venda Direta Credito**.\n4. Under **Process with provider**, select the previously configured connector.\n5. Activate the condition in the **Status** field.\n6. If you want to use an anti-fraud system, select the option **Use anti-fraud solution**.\n7. If you want, you can also [configure special payment conditions](https://help.vtex.com/docs/tutorials/special-conditions).\n8. Click `Save`.\n\nAfter 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**."}