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.
- 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 Transparente , 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 Transparente , 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 | Neste campo, configure como imediato o prazo para captura dos pagamentos aprovados. |
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 financiamento sem cartĂŁo ou 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.