Como migrar a versão de gateway
Se você já possui um cadastro de afiliação do gateway MercadoPagoV1, deve estar ciente de que em breve ele será descontinuado e a migração para MercadoPagoV2 se tornará obrigatória para continuar processando pagamentos em lojas VTEX.
O MercadoPagoV2 permite disponibilizar os mesmos meios de pagamento e também adicionar pagamentos em dinheiro . Também será possível ativar o 3DS (3-D Secure), um protocolo criado para proteger transações em lojas online por meio de uma camada adicional de verificação de identidade antes da autorização final, o que tornará suas transações ainda mais seguras e aumentará a taxa de aprovação de seus pagamentos.
Para realizar a migração do MercadoPagoV1 para o MercadoPagoV2, siga os seguintes passos:
1. Registre uma afiliação do gateway MercadoPagoV2
Se você já possui uma afiliação com o gateway MercadoPagoV1, agora deverá criar uma nova afiliação com o MercadoPagoV2. É simples e semelhante ao processo que você fez ao configurar o conector anterior. Portanto, se atente especialmente ao processo e à descrição dos campos a seguir.
- No painel de administração de sua loja VTEX, acesse Pagamentos > Provedores.
- Na parte superior da tela, clique no botão Novo provedor para criar uma nova afiliação.
- Procure pelo conector MercadoPagoV2 e selecione-o. Isso irá te levar para uma nova tela.
- Nesta tela, escolha qual será o Nome da afiliação dentro da loja. Além disso, certifique-se de ter desmarcado a opção "Ativar modo de teste".
- Após, preencha os campos correspondentes:
| Campo | Descrição |
| Application Key | Refere-se às suas credenciais de produção do Mercado Pago. Complete com sua Public Key. |
| Application Token | Refere-se às suas credenciais do Mercado Pago. Complete com seu Access Token. |
| Prazo de vencimento do boleto | Prazo, em dias úteis, de vencimento do pedido de compra. Caso o cliente efetue o pagamento após o prazo, o dinheiro será depositado na conta do cliente no Mercado Pago. |
| Nome da loja | Nome da loja. O valor deste campo aparecerá na fatura do cartão do cliente. |
| Parcelamento máximo | Número máximo de parcelas disponíveis para efetuar o pagamento. Com o Mercado Pago, você pode oferecer parcelamento em até 12 vezes. |
| Suporte 3DS 2.0 | 3-D Secure é um protocolo criado para proteger transações em comércio eletrônico por meio de uma camada adicional de verificação de identidade antes da autorização final. Apenas transações rejeitadas por Alto Risco são enviadas para validação do 3DS e não afetam a experiência de compra. Para ativá-lo, desative a opção Modo binário e selecione a opção "Sim". Certifique-se de ter instalado o Mercado Pago Payment App para que ele funcione corretamente. |
| Categoría principal da loja | Ramo de atividades da loja. |
| Compartilhamento da categoría (loja ou produto) por transação | Para ajudar nosso sistema de prevenção de fraudes, você tem a opção de compartilhar os dados da categoria da loja ou do produto para cada transação realizada. Recomendamos selecionar a opção Categoria da Loja. |
| Reembolso automático / manual | Em caso de cancelamento, você pode escolher se deseja que o Mercado Pago reembolse automaticamente o dinheiro ou se deseja reter o valor pago para que o cliente possa usá-lo em compras futuras na mesma loja. |
| Modo binário | Configure se deseja que a loja aceite pagamentos pendentes. Se você selecionar a opção "Não", a transação ficará pendente por 48 horas ou até que o pagamento seja realizado, e o estoque envolvido nessa compra será retido pelo mesmo período de tempo. Se você selecionar "Sim", as transações pendentes serão rejeitadas e o estoque será liberado automaticamente. Importante: para usar o 3DS, o modo binário precisa estar desativado. |
| Métodos de pagamento excluídos | Se você deseja oferecer pagamentos com o Checkout Pro, você pode excluir métodos de pagamento para que não estejam disponíveis no momento da compra. Você precisará digitar os nomes de cada um, conforme mostrado nos Tipos e Métodos de Pagamento. Você estará excluindo métodos de pagamento específicos (visa, Pix, amex, etc.). Tenha em mente que, durante o processo de configuração de pagamentos, você precisará selecionar individualmente os meios de pagamento que deseja oferecer. Excluir métodos e tipos de pagamento nesta etapa limitará essas opções apenas no caso de integrar o Checkout Pro. Se você integrar o Checkout API , essas configurações não terão impacto. |
| Tipos de pagamento excluídos | Ao integrar o Checkout Pro, você também pode excluir tipos de pagamento completos, como cartão de crédito (credit_card), cartão de débito (debit_card) e boleto (ticket). Você pode verificar as opções disponíveis na seção Excluir tipos e métodos de pagamento. Certifique-se de digitar os nomes exatamente como estão listados para garantir a exclusão correta. Tenha em mente que, durante o processo de configuração de pagamentos, você precisará selecionar individualmente os meios de pagamento que deseja oferecer. Excluir métodos e tipos de pagamento nesta etapa limitará essas opções apenas no caso de integrar o Checkout Pro. Se você integrar o Checkout API , essas configurações não terão impacto. |
| Modo de processamento | Selecione a opção Aggregator. |
| Integrator ID | Se você é um desenvolvedor, preencha com sua identificação do Mercado Pago. |
| Moeda | Este campo identifica a moeda da loja. Você não precisa completá-lo. |
| Merchant Account | Este campo identifica a conta do merchant. Você não precisa completá-lo. |
| Prazo de captura de pagamento aprobado | Você pode configurar um atraso na captura do pagamento que a VTEX realiza selecionando nas opções do menu suspenso. Se não quiser configurá-lo, selecione "Desativado". |
| Tempo para cancelar carrito abandonado | Configure o intervalo de tempo que deve ser aguardado até que os meios de pagamento habilitados não estejam disponíveis para efetuar a compra. Você pode selecionar um intervalo de tempo nas opções suspensas ou escolher “não cancelar”. |
- Depois de preencher todos os campos, clique em Salvar e pronto! Sua afiliação com o MercadoPagoV2 já está ativada.
2. Configurar meios de pagamento
Se você já configurou seus meios de pagamento com a afiliação MercadoPagoV1, deverá migrar para o MercadoPagoV2 para cada um dos meios que você disponibilizou. O conector V2 permitirá que você ofereça os mesmos meios de pagamento e também adicione novas opções, como pagamentos com dinheiro na conta do Mercado Pago.
Para fazé-lo, siga os passos abaixo.
- Acesse o painel de administração da sua plataforma VTEX> Pagamentos > Configuração.
- Selecione Condições de Pagamento no painel superior e escolha o meio de pagamento que deseja configurar.
- Em Processo de afiliação, substitua MercadoPagoV1 por MercadoPagoV2.
- Repita o processo com os demais meios de pagamento que você disponibilizou em sua plataforma.
Ao concluir o processo, você terá configurado sua nova afiliação do gateway MercadoPagoV2 e poderá continuar operando com o Mercado Pago, aproveitando as novas vantagens que esse conector oferece.