Integrar Mercado Pago
Aprenda como conectar sua conta do Mercado Pago para aceitar pagamentos no sistema, configurar credenciais de produção, webhooks e gerenciar canais de pagamento.
Neste artigo, você aprenderá como conectar sua conta do Mercado Pago para aceitar pagamentos no sistema. Para concluir a configuração, você precisará das suas credenciais de produção do Mercado Pago e talvez também precise configurar as notificações de webhook nas configurações de desenvolvedor do Mercado Pago.
O que é o Mercado Pago?
O Mercado Pago é um provedor de pagamentos que as empresas podem usar para aceitar pagamentos de clientes, principalmente nos mercados da América Latina. O sistema integra-se ao Mercado Pago, permitindo que as empresas o conectem diretamente à sua conta, em vez de depender de soluções alternativas ou configurações de pagamento manuais.
Após a conexão, as empresas podem gerenciar o provedor em Pagamentos > Integrações e escolher onde usá-lo nos canais de pagamento compatíveis do sistema.
Principais benefícios do Mercado Pago
- Experiência localizada: Ofereça métodos de pagamento em que seus clientes já confiam.
- Melhores conversões: Reduza o atrito no checkout com fornecedores conhecidos.
- Expansão de mercado: Explore um ecossistema de pagamentos em rápido crescimento na América Latina.
- Mais controle: Decida como e onde o Mercado Pago se encaixa na sua infraestrutura de pagamentos.
Pré-requisitos e Requisitos
Uma configuração bem-sucedida do Mercado Pago depende de ter as credenciais corretas, as configurações da conta e as informações do webhook preparadas antes de começar.
Antes de começar, certifique-se de ter:
- Uma conta Mercado Pago com suporte para CVV/CVC ativado.
- Acesso ao seu painel de controle de desenvolvedor do Mercado Pago.
- O endereço URL do site da sua empresa, caso o Mercado Pago o solicite ao ativar as credenciais de produção.
Observação
Pagamentos em produção exigem credenciais de produção (não credenciais de teste). As credenciais de produção estão vinculadas a um aplicativo que você cria no Mercado Pago em Suas integrações.
Você precisará destes valores do Mercado Pago:
- Chave pública
- Token de acesso
- País da conta
- Segredo do webhook
Notas importantes
- Use as credenciais de produção para pagamentos reais. As credenciais de teste são apenas para testes e não processarão transações em tempo real.
- Mantenha seu token de acesso em sigilo e guarde-o em local seguro.
- Dependendo da configuração do Mercado Pago no seu país, as opções disponíveis podem variar. Cada país tem um número mínimo de contas diferente; consulte as Perguntas Frequentes para obter mais detalhes.
- Para que essa integração funcione corretamente, sua conta do Mercado Pago precisa ter o suporte para CVV sem autenticação ativado.
- O Mercado Pago não permite que dois elementos de finalização de compra sejam exibidos em uma única página; por exemplo, não é possível manter dois formulários de pedido de uma etapa em um funil de vendas.
Como configurar o Mercado Pago
Uma configuração adequada garante que o sistema possa se conectar ao Mercado Pago, encaminhar pagamentos corretamente e receber atualizações de eventos de pagamento por meio de webhooks. Concluir cada etapa cuidadosamente ajuda a evitar falhas de conexão e problemas de sincronização posteriormente.
Passo 1: Abra o Mercado Pago em Integrações de Pagamento
- 1
No sistema, acesse Pagamentos na navegação à esquerda.
- 2
Abra a aba Integrações.
- 3
Encontre o Mercado Pago na lista de fornecedores e clique em Conectar.
Etapa 2: Obtenha suas credenciais de produção do Mercado Pago
- 1
Faça login na sua conta do Mercado Pago.
- 2
Abra a área de desenvolvedores do Mercado Pago.
- 3
Acesse Suas integrações.
- 4
Abra uma solicitação existente ou crie uma nova.
- 5
Acesse as credenciais de produção e copie a chave pública e o token de acesso. Se as credenciais de produção ainda não estiverem ativas, preencha os dados comerciais necessários, como seu setor de atuação e site.
Se você precisar criar um novo aplicativo:
Se você ainda não possui um aplicativo no Mercado Pago, crie um primeiro. Na maioria dos casos, o Mercado Pago solicitará que você:
- Insira o nome do aplicativo.
- Escolha o tipo de pagamento ou o caso de uso comercial para pagamentos online.
- Confirme os detalhes da sua configuração.
- Habilite as credenciais de produção e use-as na etapa 2.
Passo 3: Insira suas credenciais do Mercado Pago
- 1
Cole a chave pública no campo correspondente.
- 2
Cole o token de acesso no campo correspondente.
- 3
Selecione o país ou a região da conta correta.
- 4
Gere ou insira sua chave secreta do Webhook no campo correspondente.
- 5
Clique em Salvar ou Conectar.
Após salvar, sua conta do Mercado Pago deverá estar vinculada. Agora, vamos habilitar os webhooks no aplicativo do Mercado Pago.
Passo 4: Configurar webhooks no Mercado Pago
Algumas integrações do Mercado Pago exigem notificações via webhook para que os eventos de pagamento sejam sincronizados corretamente com a sua plataforma. Faça login na sua conta do Mercado Pago e acesse o painel do desenvolvedor (https://www.mercadopago.com.br/developers/en).
- 1
No Mercado Pago, abra o aplicativo usado para a integração e acesse Webhooks.
- 2
Clique em Configurar notificações.
- 3
Conclua a configuração do webhook necessária para que os eventos de pagamento sejam sincronizados corretamente.
- 4
Cole o URL do webhook no campo URL do modo de produção: https://backend.LeadConnectorhq.com/payments/mercado-pago/webhook
- 5
Adicione o segredo do Webhook da mesma forma que na página do Lead Connector.
- 6
Selecione o evento "Pagamento" necessário para sua integração.
- 7
Salve suas alterações.
Passo 5: Atribuir Mercado Pago por canal
Após a integração estar conectada, abra "Gerenciar configurações do provedor para Mercado Pago".
- Alterne entre os modos Ao Vivo e Teste conforme necessário.
- Atribua o Mercado Pago aos canais onde deseja que ele esteja disponível.
Dica
Para obter mais detalhes sobre como atribuir provedores de pagamento por canal, consulte Configurar provedores de pagamento por canal.