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.
To configure MercadoPagoV2, follow the steps below:
- In the VTEX Admin, go to Store Settings > Payment > Providers, or type Providers in the search bar at the top of the page.
- On the providers screen, click the
New Provider
button. - Type the name MercadoPagoV2 in the search bar and click on the name of the provider.
- In Provider Authorization, fill in the registration fields App key and App token with the data provided by Mercado Pago.
- 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.
- In Payment Control, select whether you want to activate the provider in a test environment by clicking Enable test mode.
- 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.
- 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.
- In Parcelamento máximo ("Max installments"), choose the maximum number of installments sent to MercadoPago.
- 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.
- In Categoria principal da loja ("Main store category"), choose the category of your store's industry.
- 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.
- 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.
- 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).
- 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.
- 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.
- 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? and What is a payment gateway?.
- In the Integrator ID option, indicate the identifier code of the developer or agency that performs the Mercado Pago configuration.
- In the Moeda ("Currency") option, choose whether the currency used for payment will be "Local" (each country) or "US Dollar" (USD).
- The Merchant Account ID field identifies the merchant account. It is not necessary to fill it out.
- In Prazo de captura de pagamento aprovado ("Approved payment capture deadline"), select the desired deadline for payment capture.
- 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.
- Click Save.
Setting up payment conditions
To configure the default payment methods to be processed by MercadoPagoV2, access Configuring Payment Conditions.
To set special conditions on payment methods, go to Configuring payment special conditions.
Setting up exclusive payment methods
To configure exclusive Mercado Pago payment methods, go to setting up Mercado Pago Offline and Wallet as payment methods.
For more information about integration with Mercado Pago, access the DevSite Mercado Pago.