Guia completo de Mercado Pago
Conecte o Mercado Pago ao app Cobranças para criar checkouts e receber atualizações automáticas.
Tour visual na empresa Demo
Da configuração ao acompanhamento
Use as telas reais abaixo para reconhecer cada etapa sem expor credenciais.
1 Abrir configuração
Configure a integração
Preencha somente as credenciais da própria empresa e salve.
Etapa 1 de 2
01PrepareSepare conta e credenciais.
02ConfigurePreencha e salve com segurança.
03TesteUse um cenário demonstrativo.
04AcompanheValide o resultado e os logs.
O que esta integração faz
| Integração | Mercado Pago |
| Categoria | Gateway de pagamento |
| Configuração | Individual por empresa; credenciais não são compartilhadas. |
| Acesso | Integrações > Mercado Pago |
Conecte o Mercado Pago ao app Cobranças para criar checkouts e receber atualizações automáticas.
Antes de configurar
- Conta Mercado Pago habilitada para receber.
- Aplicação criada em Suas integrações.
- Public Key e Access Token da mesma aplicação.
- Acesso para configurar notificações/webhooks.
Public Key e Access Token precisam pertencer à mesma aplicação e ao mesmo ambiente. Nunca publique o Access Token.
Passo a passo completo
- Abra Integrações e acesse Mercado Pago.
- Informe Public Key e Access Token da aplicação.
- Defina o segredo do webhook quando usado na validação.
- Salve a integração.
- Copie a URL mostrada no CRM e cadastre-a nas notificações do Mercado Pago.
- Selecione Mercado Pago em Apps > Cobranças > Configurações.
- Crie um checkout piloto e acompanhe o evento na aba Logs.
Primeiro teste recomendado
Faça uma configuração controlada na empresa Demo, confirme o resultado esperado e somente depois replique em uma operação real.
Entenda os campos e elementos
| Public Key | Identifica publicamente a aplicação no checkout. |
| Access Token | Credencial privada usada nas operações da API. |
| Segredo do webhook | Valida a assinatura das notificações recebidas. |
| URL do webhook | Destino das atualizações de pagamento. |
| Logs | Exibem o resultado do processamento das notificações. |
Onde e como usar
| PIX | Pagamento instantâneo no checkout. |
| Boleto | Opção conforme disponibilidade da conta. |
| Cartão | Checkout com cartão e regras do Mercado Pago. |
| Cobranças | Criação e acompanhamento pelo app do CRM. |
A configuração conecta o provedor. O recurso efetivamente usado é escolhido no agente, automação ou app Cobranças, conforme a categoria.
Diagnóstico rápido
| Credenciais rejeitadas | Confirme se as chaves são da mesma aplicação. |
| Webhook não chega | Revise a URL e os eventos cadastrados no Mercado Pago. |
| Pagamento pendente | Consulte o status no gateway e aguarde a notificação final. |
| Erro de assinatura | Confira o segredo do webhook configurado nos dois lados. |
Checklist de segurança
- Use somente credenciais pertencentes à empresa.
- Nunca envie chaves, tokens ou segredos por mensagens.
- Comece em ambiente de teste quando o provedor oferecer essa opção.
- Revise permissões e limites da conta externa.
- Faça um primeiro teste controlado.
- Consulte logs e confirme o resultado antes de liberar para a equipe.
Dúvidas frequentes
Onde encontro as credenciais?
Na aplicação criada em Suas integrações no Mercado Pago.
Posso usar credenciais de teste?
Sim, para validar o fluxo antes da produção.
O checkout fica dentro do CRM?
O CRM gera e envia o link; o pagamento ocorre no ambiente seguro do gateway.
Como diagnosticar uma confirmação ausente?
Abra Logs e compare com as notificações da aplicação.
O suporte precisa da minha chave para ajudar?
Não envie a credencial. Compartilhe apenas prints sem dados sensíveis, a mensagem de erro e o horário do teste.