Configurar provedor de pagamentos
A implementação em lojas VTEX consiste em duas etapas. Primeiro, é necessário instalar o Mercado Pago Payment App para garantir a conciliação das transações entre ambas as plataformas. Em seguida, você deverá configurar o Mercado Pago como provedor de pagamentos.
1. Instalar Mercado Pago Payment App
A instalação do Mercado Pago Payment App deve ser solicitada ao Suporte da VTEX. Siga os passos abaixo para saber como realizar a solicitação.
- No painel de administração da VTEX, localizado no canto esquerdo, vá para Aplicativos > Gerenciamento de aplicativos.
- Clique no ponto de interrogação (“?”) no canto superior direito da tela.
- Selecione a opção Fale com nossos especialistas.
- Preencha os campos solicitados com seu e-mail, nome, e identificação da conta. Clique Continue.
- Selecione a opção Technical e solicite a instalação do Mercado Pago Payment App para a loja.
A partir deste ponto, você finalizará a instalação do aplicativo com o Suporte VTEX.
Uma vez concluído este processo, é necessário configurar o aplicativo. Para isso, acesse Apps > Hub de extensões > Gerenciamento de aplicações, localize a aplicação, e clique no botão Settings. Em seguida, preencha o campo Application Key com sua Public KeyChave pública da aplicação, que é utilizada no frontend para acessar informações e criptografar dados, seja na etapa de desenvolvimento ou na de testes. e clique em Salvar.
Desta forma, você terá finalizado a instalação do Mercado Pago Payment App e poderá continuar com suas configurações.
2. Configurar o Mercado Pago como provedor de pagamentos
Siga as etapas abaixo para realizar a configuração.
- No seu painel de administração da plataforma VTEX, vá para Configurações da loja > Pagamento > Provedores.
- Na parte superior da tela, clique no botão Novo provedor para criar uma afiliação com o Mercado Pago.
- Utilize o buscador para encontrar o conector MercadoPagoV2 e selecione-o. Isso levará você a uma nova tela.
- Nessa tela, serão solicitadas as credenciais do Mercado Pago para a Autorização do provedor. Complete os campos conforme indicado:
| Campo | Descrição |
| Chave de aplicação | Este campo faz referência à Public Key da aplicação do Mercado Pago. Como você está em etapa de desenvolvimento, deverá utilizar a Public Key da aplicação do usuário de testeChave pública da aplicação de testes criada com seu usuário de testes. É utilizada no backend para poder testar seu desenvolvimento. Você pode acessá-la fazendo login com seu usuário de testes e acessando Suas integrações > Detalhes da aplicação > Produção > Credenciais de produção.. Mais adiante, poderá trocá-la por uma produtiva. |
| Token de aplicação | Este campo faz referência ao Access Token da aplicação do Mercado Pago. Como você está em etapa de desenvolvimento, deverá utilizar o Access Token da aplicação do usuário de testeChave privada da aplicação de testes criada com seu usuário de testes. É utilizada no backend para poder testar seu desenvolvimento. Você pode acessá-la fazendo login com seu usuário de testes e acessando Suas integrações > Detalhes da aplicação > Produção > Credenciais de produção.. Mais adiante, poderá trocá-lo por um produtivo. |
- Na seção Informações básicas, atribua um Nome à conexão com o Mercado Pago. Esse nome será utilizado para que você possa identificar essa conexão dentro da loja.
- Em Controle de pagamentos, mantenha desativado o Modo de teste para poder garantir o correto funcionamento do fluxo de testes mais adiante.
- Em seguida, no campo Liquidação automática, selecione a opção Comportamento recomendado pelo processador. Dessa forma, a VTEX respeitará os prazos de captura que você estabelecer para o Mercado Pago nos próximos passos, e você poderá contar com a segurança do nosso controle antifraudes.
- Complete os Campos do provedor seguindo as instruções abaixo.
Período, em dias úteis, para o vencimento do pedido de compra. Se o cliente pagar após o prazo, o dinheiro será depositado na sua conta do Mercado Pago. Esta configuração se aplica apenas no caso de ativar pagamentos no ambiente do Mercado Pago com Checkout Pro e meios de pagamento offline.
Nome da loja. O valor deste campo aparecerá na fatura do cartão do cliente.
Número máximo de parcelas disponíveis para efetuar o pagamento. Com o Mercado Pago, é possível oferecer parcelamento em até 12 vezes.
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.
Ramo de atividades da loja.
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.
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.
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.
Lembre-se: para usar o 3DS, o modo binário precisa estar desativado.
Permite excluir meios de pagamento para que não fiquem disponíveis no momento da compra. Essa exclusão só terá efeito caso você implemente Pagamentos no ambiente de Mercado Pago com o Checkout Pro.
Você deve digitar os nomes exatamente como aparecem em Excluir tipos e meios de pagamento (ex.: visa, rapipago, amex, etc.).
Você também pode excluir tipos de pagamento inteiros (ex.: credit_card; debit_card; ticket). Consulte as opções em Excluir tipos e meios de pagamento e digite os nomes exatamente como estão listados.
Essa exclusão só terá efeito caso você implemente Pagamentos no ambiente de Mercado Pago com o Checkout Pro.
Selecione a opção Aggregator, que é o modo de processamento de pagamentos com o Mercado Pago.
Se você é um desenvolvedor, preencha com sua identificação do Mercado Pago.
Este campo identifica a moeda da loja. Não é necessário completá-lo.
Conta do vendedor onde será depositado o dinheiro das vendas. Não é necessário preencher este campo.
Você pode configurar um atraso na captura do pagamento realizada pela VTEX, escolhendo entre as opções disponíveis no menu. Se não quiser configurar, selecione Desativado.
Configure o tempo de espera para cancelar uma compra não finalizada no checkout. Você pode escolher entre as opções disponíveis ou selecionar Não cancelar.
Depois de preencher todos os campos, clique em Salvar para completar sua conexão com o Mercado Pago como provedor de pagamentos.
Se você tiver algum problema durante essas configurações, pode consultar nosso Support Center.