Addon Mercado Pago

Gostaria de aceitar pagamentos com cartão de crédito e débito de clientes em toda a América Latina? Compradores nesta região esperam pagar em sua moeda local, com a opção de dividir uma compra em parcelas, e confiam no Mercado Pago para lidar com isso.

O addon Mercado Pago conecta seus formulários à plataforma de pagamento mais popular da América Latina para que os compradores concluam o pagamento sem sair do seu site. Este tutorial mostrará como instalar e usar o addon Mercado Pago com o WPForms.

---

Antes de começar, certifique-se de instalar e ativar o WPForms em seu site WordPress. Após verificar sua licença, você poderá instalar e ativar rapidamente o addon Mercado Pago.

Conectando o Mercado Pago ao seu site

Depois que o addon Mercado Pago for instalado e ativado, você precisará conectar sua conta Mercado Pago ao WPForms. Para fazer isso, você criará um aplicativo no seu painel Mercado Pago e, em seguida, copiará suas credenciais para as configurações de pagamento do WPForms. Explicaremos cada etapa abaixo.

Criando um aplicativo Mercado Pago

Para começar, faça login na sua conta Mercado Pago e vá para a página de Integrações no Painel do Desenvolvedor do Mercado Pago. Em seguida, clique em Criar aplicativo.

Isso abrirá o assistente de configuração, que o guiará por 4 etapas. Na primeira etapa, insira um nome para seu aplicativo, como o nome do seu site. Em seguida, clique em Continuar.

Em seguida, o Mercado Pago pergunta qual tipo de pagamento você deseja integrar. Selecione Pagamentos online.

Em seguida, em Como você configurou a loja?, selecione Com desenvolvimento próprio. Depois de fazer ambas as seleções, clique em Continuar.

Na terceira etapa, você escolherá como deseja receber pagamentos em sua loja. Na guia Checkouts, selecione Checkout Bricks. Em seguida, clique em Continuar.

Na última etapa, revise as opções que você selecionou. Em seguida, marque a caixa para aceitar a declaração de privacidade e os termos do Mercado Pago, complete o reCAPTCHA e clique em Confirmar.

O Mercado Pago criará o aplicativo e o levará para a página de visão geral.

Obtendo suas credenciais do Mercado Pago

Em seguida, você precisará das credenciais do aplicativo. No menu do lado esquerdo da página do seu aplicativo, em Produção, clique em Credenciais de produção.

Em seguida, copie a Chave pública e o Token de acesso.

Mantenha esta página aberta. Você colará ambos os valores no WPForms na próxima etapa.

Finalizando a Conexão no WPForms

Na área de administração do seu WordPress, vá para WPForms » Configurações e clique na guia Pagamentos.

Primeiro, verifique a configuração de Moeda no topo da página e certifique-se de que ela corresponda à moeda do país onde sua conta do Mercado Pago está registrada.

Em seguida, role até a seção Mercado Pago. Cole a Chave pública que você copiou do Mercado Pago no campo Chave pública de produção. Em seguida, cole seu Token de acesso no campo Token de acesso de produção.

Abaixo dos campos de credenciais, deixe Ativar Webhooks ativado. Em seguida, clique em Salvar configurações.

O WPForms verifica suas chaves com o Mercado Pago enquanto as salva, então uma chave digitada incorretamente ou que não corresponde gera um erro imediatamente. Quando a conexão é bem-sucedida, o Status da Conexão exibe uma marca de verificação verde junto com o e-mail da sua conta Mercado Pago.

Adicionando o Mercado Pago aos seus formulários

Após conectar sua conta, você estará pronto para aceitar pagamentos em seus formulários. Para começar, crie um novo formulário ou edite um existente para abrir o construtor de formulários.

Seu formulário precisará de pelo menos um campo de item de pagamento, como Item Único ou Vários Itens, para que haja um valor a ser cobrado. Em seguida, na seção Campos de Pagamento do construtor, adicione o campo Mercado Pago ao seu formulário.

Assim que o campo for adicionado ao seu formulário, o WPForms solicitará que você ative os pagamentos do Mercado Pago para este formulário. Clique no botão Ativar Pagamentos do Mercado Pago para ir direto para as configurações de pagamento do formulário.

Na tela Pagamentos » Mercado Pago, ative o interruptor Ativar pagamentos do Mercado Pago se ele ainda não estiver ativado.

Em seguida, preencha as configurações para os pagamentos deste formulário:

• Descrição do Pagamento: Uma breve descrição para o pagamento, como o nome do seu produto ou serviço. Ela aparece na atividade do seu painel do Mercado Pago.
• E-mail do Cliente: O campo em seu formulário que contém o endereço de e-mail do cliente. O Mercado Pago envia o recibo para este endereço, e os compradores que o preencherem não terão seu e-mail solicitado novamente dentro do campo de pagamento.
• Nome do Cliente: O campo em seu formulário que contém o nome do cliente. Ele aparece nos detalhes do pagamento no seu painel do Mercado Pago.



O próprio campo do Mercado Pago coleta o número do cartão, a data de validade, o código de segurança e o nome do titular do cartão. Ele também solicita um endereço de e-mail, a menos que você tenha mapeado o E-mail do Cliente acima e o comprador já tenha preenchido esse campo. Quando um comprador insere um cartão que suporta parcelamento, um menu suspenso de parcelas aparece dentro do campo automaticamente para que ele selecione em quantas vezes dividir a cobrança. Não há nada para configurar para isso.

Quando terminar, salve seu formulário. Ele agora está pronto para aceitar pagamentos.

Testando pagamentos do Mercado Pago

Antes de começar a receber pagamentos reais, vale a pena fazer um pagamento através do seu formulário. O WPForms inclui um modo de teste para o Mercado Pago que permite completar todo o fluxo sem que nenhum dinheiro seja movimentado.

Ativando o modo de teste

Para garantir que nenhum pagamento real seja processado enquanto você está testando, vá para WPForms » Configurações no seu painel do WordPress e clique em Pagamentos.

Em Mercado Pago, ative o interruptor Modo de Teste e, em seguida, clique em Salvar Configurações. A página será atualizada e os campos Chave Pública de Teste e Token de Acesso de Teste aparecerão no lugar dos de produção.



Observação: O modo de teste e o modo ativo são configurados separadamente, portanto, você precisará adicionar suas chaves de teste aqui, mesmo que já tenha conectado suas chaves de produção.

Agora volte para o seu aplicativo Mercado Pago e clique em Credenciais de teste no menu à esquerda.



Copie a Chave pública e cole-a no campo Chave pública de teste nas configurações de pagamento do seu WPForms.

Em seguida, copie o Token de acesso, cole-o no campo Token de acesso de teste e clique em Salvar configurações.



Realizando um pagamento de teste

Em seguida, abra uma página com seu formulário Mercado Pago e preencha o formulário como um cliente faria.

Para os detalhes do cartão, use um dos cartões de teste que o Mercado Pago fornece para o seu país.

Para o nome do titular do cartão, o Mercado Pago decide o resultado de um pagamento de teste com base no que você digita aqui, portanto, insira um destes códigos de status:

• APRO: O pagamento é aprovado.
• CONT: O pagamento permanece pendente.
• OTHE: O pagamento é recusado com um erro geral.
• FUND: O pagamento é recusado por valor insuficiente.

Para realizar um pagamento de teste bem-sucedido, use APRO. Em seguida, envie o formulário normalmente.

Visualizando seus pagamentos de teste

Pagamentos de teste não aparecem no seu painel do Mercado Pago. Para encontrá-los, vá para WPForms » Pagamentos e ative a opção Dados de teste.



Para detalhes completos sobre como visualizar informações de pagamentos de teste e em tempo real, entender tendências de transações, ajustar para diferentes moedas e muito mais, confira nosso guia sobre visualização e gerenciamento de pagamentos.

Configurando Lógica Condicional (Opcional)

Lógica condicional permite que você decida quando uma cobrança do Mercado Pago deve ser processada, com base no que o usuário seleciona em seu formulário. Por exemplo, você pode querer pular a cobrança quando o usuário escolher uma opção gratuita.

Para configurar isso, vá para Pagamentos » Mercado Pago no construtor de formulários e ative Habilitar Lógica Condicional. Em seguida, crie a regra que decide quando processar a cobrança.



Criação de E-mails de Notificação Condicional para Pagamentos Concluídos

Você pode querer enviar um email de notificação somente após um pagamento ter sido efetivamente realizado, como um recibo ou um alerta de cumprimento para sua equipe.

Para fazer isso, vá para Configurações » Notificações no construtor de formulários e abra a notificação que você deseja limitar. Em seguida, marque a caixa rotulada Habilitar para pagamentos concluídos do Mercado Pago. Esta notificação agora só será enviada quando um pagamento do Mercado Pago for concluído com sucesso.



Perguntas Frequentes

Abaixo, abordamos algumas das perguntas mais comuns sobre o uso do addon Mercado Pago.

Quais países e moedas o addon Mercado Pago suporta?

O addon funciona com contas Mercado Pago registradas na Argentina, Brasil, Chile, Colômbia, México, Peru e Uruguai. Os pagamentos são processados na moeda do país da sua conta: ARS, BRL, CLP, COP, MXN, PEN ou UYU. Defina a moeda correspondente em WPForms » Configurações » Pagamentos.

Por que estou vendo um erro de moeda nas minhas configurações de pagamento?

Este aviso aparece quando a moeda do WPForms não corresponde à moeda do país da sua conta Mercado Pago. O Mercado Pago processa pagamentos apenas na moeda do país da sua conta, portanto, os pagamentos permanecem pausados até que correspondam. Para corrigir, vá para WPForms » Configurações » Pagamentos e atualize a configuração de Moeda.

Por que não vejo opções de parcelamento no campo de pagamento?

O dropdown de parcelas só aparece depois que um número de cartão completo e válido é inserido, já que o Mercado Pago usa o próprio cartão para descobrir quais planos ele suporta. Os planos disponíveis também dependem do tipo de cartão e do valor do pagamento. Cartões de débito, por exemplo, geralmente não oferecem parcelamento, e valores menores podem se qualificar apenas para um único pagamento.

Por que o campo de pagamento não solicita o e-mail dos compradores?

Se você mapeou E-mail do cliente nas configurações do Mercado Pago do seu formulário e o comprador preenche esse campo, o campo de pagamento pula sua própria etapa de e-mail e usa o endereço que eles já forneceram. Ele só coleta um e-mail quando nenhum campo é mapeado ou o campo mapeado é deixado em branco.

Por que meus pagamentos de teste estão sendo recusados?

Primeiro, verifique o nome do titular do cartão. O Mercado Pago decide o resultado de um pagamento de teste com base no que você digita lá, então ele precisa ser um código de status como APRO para um pagamento aprovado. Se o nome estiver correto e os pagamentos ainda falharem, verifique o endereço de e-mail na sua submissão. O Mercado Pago recusa pagamentos de endereços de e-mail que parecem gerados automaticamente, então use um endereço realista ao testar.

Preciso configurar webhooks no meu painel do Mercado Pago?

Não. O WPForms compartilha automaticamente o endereço do webhook com o Mercado Pago, então reembolsos, chargebacks e atualizações de pagamento atrasadas são sincronizados com seu site automaticamente. Apenas mantenha a configuração Ativar Webhooks ativada em WPForms » Configurações » Pagamentos.

O WPForms armazena os dados do cartão dos meus clientes?

Não. Os campos de cartão no campo do Mercado Pago são hospedados pelo Mercado Pago, então os detalhes do cartão vão diretamente para o Mercado Pago e nunca tocam seu site. O WPForms recebe apenas um token seguro de uso único para criar o pagamento, juntamente com a bandeira do cartão e os últimos 4 dígitos para seus registros.

Pronto! Agora você pode aceitar pagamentos com cartão de crédito e débito, completos com parcelamento, através do addon Mercado Pago do WPForms.

Em seguida, quer ficar de olho nos pagamentos que chegam através dos seus formulários? Confira nosso guia para visualizar e gerenciar pagamentos para saber mais sobre detalhes de pagamento, status e reembolsos.