Inicio
Documentação
Recursos
Parcerias
Comunidade

Recursos

Confira as atualizaçÔes das nossas soluçÔes e do funcionamento do sistema ou peça suporte técnico.

Parcerias

Conheça nosso programa para agĂȘncias ou desenvolvedores que oferecem serviços de integração e vendedores que desejam contratĂĄ-los.

Comunidade

Fique por dentro das Ășltimas novidades, peça ajuda a outros integradores e compartilhe seu conhecimento.

Como migrar a versĂŁo de gateway - VTEX - Mercado Pago Developers

Busca inteligente powered by OpenAI 

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 ou parcelados sem cartão. 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.

  1. No painel de administração de sua loja VTEX, acesse Pagamentos > Provedores.
  2. Na parte superior da tela, clique no botão Novo provedor para criar uma nova afiliação.
  3. Procure pelo conector MercadoPagoV2 e selecione-o. Isso irĂĄ te levar para uma nova tela.
  4. 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".
  5. ApĂłs, preencha os campos correspondentes:
CampoDescrição
Application KeyRefere-se às suas credenciais de produção do Mercado Pago. Complete com sua Public Key.
Application TokenRefere-se Ă s suas credenciais do Mercado Pago. Complete com seu Access Token.
Prazo de vencimento do boletoPrazo, 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 lojaNome da loja. O valor deste campo aparecerĂĄ na fatura do cartĂŁo do cliente.
Parcelamento mĂĄximoNĂș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.03-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 lojaRamo de atividades da loja.
Compartilhamento da categorĂ­a (loja ou produto) por transaçãoPara 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 / manualEm 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ĂĄrioConfigure 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Ă­dosSe 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 Transparente , essas configuraçÔes nĂŁo terĂŁo impacto.
Tipos de pagamento excluĂ­dosAo 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 Transparente , essas configuraçÔes nĂŁo terĂŁo impacto.
Modo de processamentoSelecione a opção Aggregator.
Integrator IDSe vocĂȘ Ă© um desenvolvedor, preencha com sua identificação do Mercado Pago.
MoedaEste campo identifica a moeda da loja. VocĂȘ nĂŁo precisa completĂĄ-lo.
Merchant AccountEste campo identifica a conta do merchant. VocĂȘ nĂŁo precisa completĂĄ-lo.
Prazo de captura de pagamento aprobadoNeste campo, configure como imediato o prazo para captura dos pagamentos aprovados.
Tempo para cancelar carrito abandonadoConfigure 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”.
  1. Depois de preencher todos os campos, clique em Salvar e pronto! Sua afiliação com o MercadoPagoV2 jå estå ativada.

Configure MercadoPagoV2

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 financiamento sem cartĂŁo ou pagamentos com dinheiro na conta do Mercado Pago.

Para fazé-lo, siga os passos abaixo.

  1. Acesse o painel de administração da sua plataforma VTEX> Pagamentos > Configuração.
  2. Selecione CondiçÔes de Pagamento no painel superior e escolha o meio de pagamento que deseja configurar.
  3. Em Processo de afiliação, substitua MercadoPagoV1 por MercadoPagoV2.
  4. Repita o processo com os demais meios de pagamento que vocĂȘ disponibilizou em sua plataforma.

Configure v2 in payment methods

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.