{"section":"tutorials","requestedLocale":"en","requestedSlug":"setting-up-mercadopagov2-sub-acquirer","locale":"en","slug":"setting-up-mercadopagov2-sub-acquirer","path":"docs/en/tutorials/payments/payment-settings/setting-up-mercadopagov2-sub-acquirer.md","branch":"main","content":"At VTEX, it is possible to integrate with the payment provider MercadoPagoV2. Through it, your store can receive payments using traditional methods, such as: bank slip, PIX, debit and credit cards, as well as through exclusive Mercado Pago methods, such as: MercadoPagoOff, MercadoPagoPro and MercadoPagoWallet.\n\nTo configure MercadoPagoV2, follow the steps below:\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__, fill in the registration fields __App key__ and __App token__ with the data provided by Mercado Pago.\n5. 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__.\n6. In __Payment Control__, select whether you want to activate the provider in a test environment by clicking __Enable test mode__.\n7. In the __Prazo de vencimento do boleto__ (“Boleto expiration date”), choose the number of days (counting from the creation of the invoice) that your customer will have to make the payment.\n8. In __Nome da loja__ (\"Store name\"), enter your company name. This information will be described in the Beneficiary field of the bill or on the customer's card invoice.\n9. In __Parcelamento máximo__ (\"Max installments\"), choose the maximum number of installments sent to MercadoPago.\n10. In __Suporte 3DS 2.0__ (\"3DS 2.0 Support\"), select \"Sí\" if you want to enable 3DS security validation. For this protocol to work correctly, make sure that the __Mercado Pago Payment app__ is already installed in your store and that the __Modo binário__ (\"Binary Mode\") field (step 14) is selected as __No__.\n11. In __Categoria principal da loja__ (\"Main store category\"), choose the category of your store's industry.\n12. In __Compartilhamento de categoria (loja ou produto) por transação__ (\"Category sharing (store or product) per transaction\"), select whether you want to share store or product category data with Mercado Pago in each transaction.\n13. In the option __Reembolso automático / manual__ (\"Automatic / manual refund\"), choose whether the customer will be refunded automatically or manually in case of order cancellation.\n14. In __Modo binário__ (\"Binary Mode\"), indicate whether the store should accept pending payments. Selecting \"Yes\" indicates that the payment approval process occurs instantly, and can be approved or rejected. Selecting \"No\" defines that the payment can remain in \"pending\" status (if it requires any action from the buyer) or \"in process\" (if manual review is required).\n15. In __Métodos de pagamento excluídos__ (\"Excluded payment methods\"), describe the payment methods you do not want to use through MercadoPagoV2 (optional). If you choose to leave this field blank, all available payment methods from MercadoPagoV2 will be available in your store.\n16. In __Tipos de pagamento excluídos__ (\"Excluded payment types\"), describe the specific credit and debit brands (Visa, Mastercard, among others) that you do not want to use through MercadoPagoV2 (optional). If you choose to leave this field blank, all available payment types from MercadoPagoV2 will be available in your store.\n17. In __Modo de processamento__ (\"Processing Mode\"), choose how you want to use MercadoPagoV2: as a subacquirer (aggregator) or gateway. For more information, access [What is a sub-acquirer?](/en/docs/tutorials/what-is-a-sub-acquirer) and [What is a payment gateway?](/en/docs/tutorials/what-is-a-payment-gateway).\n18. In the __Integrator ID__ option, indicate the identifier code of the developer or agency that performs the Mercado Pago configuration.\n19. In the __Moeda__ (\"Currency\") option, choose whether the currency used for payment will be \"Local\" (each country) or \"US Dollar\" (USD).\n20. The __Merchant Account ID__ field identifies the merchant account. It is not necessary to fill it out.\n21. In __Prazo de captura de pagamento aprovado__  (\"Approved payment capture deadline\"), select the desired deadline for payment capture.\n22. Em __Tempo para cancelar compras de um carrinho abandonado__ (\"Time to cancel purchases from an abandoned cart\"), enter the time interval that must be waited until the enabled payment methods are not available to make the purchase.\n23. Click __Save__.\n\n## Setting up payment conditions\n\nTo configure the default payment methods to be processed by MercadoPagoV2, access [Configuring Payment Conditions](/en/docs/tutorials/how-to-configure-payment-conditions).\n\nTo set special conditions on payment methods, go to [Configuring payment special conditions](/en/tutorial/special-conditions--tutorials_456#).\n\n## Setting up exclusive payment methods\n\nTo configure exclusive Mercado Pago payment methods, go to [setting up Mercado Pago Offline and Wallet as payment methods](/en/tutorial/configurar-mercado-pago-offline-e-wallet-como-metodos-de-pagamentos).\n\nFor more information about integration with Mercado Pago, access the [DevSite Mercado Pago](https://www.mercadopago.com.br/developers/en/guides/plugins/unofficial/vtex/gateway-affiliations)."}