Este artigo mostra como ligar o Mercado Pago ao sistema: pegar o Access Token, cadastrá-lo e entender como os pagamentos são avisados. Antes, leia Pagamentos: como funciona a integração para entender o que é sincronizado.
Onde encontrar (caminho até a tela):
- Pagamentos: Menu lateral › Configurações › aba Pagamentos › cartão Mercado Pago
- No Mercado Pago: Mercado Pago Developers › Suas integrações
Precisa da permissão Gerenciar métodos de pagamento. Também dá para chegar pelo botão Cadastrar chave do aviso no Faturamento.
O sistema só acompanha as faturas geradas dentro dele. Pagamentos criados direto no Mercado Pago não entram.
Passo 1: pegar o Access Token
- Entre no site de desenvolvedores do Mercado Pago (Mercado Pago Developers) com a conta da empresa.
- Clique em Suas integrações, no canto superior direito.
- Crie uma aplicação ou abra uma que já exista.
- No menu à esquerda, abra Produção › Credenciais de produção.
- Na primeira vez, preencha Indústria e Site (a página do seu negócio), aceite a declaração de privacidade e os termos e clique em Ativar credenciais de produção.
- Copie o Access Token. A Public Key não é usada aqui.
- O Access Token é secreto: nunca deve ficar exposto em páginas públicas.
- As credenciais de teste servem só para simular pagamentos. Para receber de verdade, use o Access Token de produção.
- Os nomes das telas do Mercado Pago podem mudar com o tempo. Se algo estiver diferente, consulte a documentação oficial.
Passo 2: cadastrar no sistema
- Vá em Configurações › Pagamentos.
- No cartão Mercado Pago, cole o valor no campo Access Token.
- Deixe Ativo ligado e marque Principal se quiser.
- Clique em Salvar. A chave passa a aparecer só com os 4 últimos caracteres.
Passo 3: como os pagamentos são avisados
No Mercado Pago, o sistema envia o endereço de aviso junto com cada link gerado, e esse endereço leva a identificação da empresa e da fatura. O Mercado Pago dá prioridade ao endereço enviado junto com o pagamento sobre o configurado no painel. Por isso, em geral não é preciso configurar nada no painel do Mercado Pago.
- O endereço precisa ser público e em HTTPS. Endereço local (localhost) não recebe avisos.
- O sistema responde HTTP 200 ao Mercado Pago, que é o que ele espera para considerar o aviso entregue. Se não receber 200, o Mercado Pago tenta de novo.
A URL de webhook mostrada na tela, sozinha, não informa de qual empresa é o pagamento. Quem informa é o endereço que o sistema envia com cada link. Registrar a URL base no painel do Mercado Pago não substitui isso e, sozinha, não atualiza fatura.
Passo 4: testar
- Crie uma fatura de valor baixo para um cliente seu e gere o link. Veja Link de pagamento, envio ao cliente e régua de cobrança.
- Pague pelo link. Para um teste sem dinheiro real, use credenciais e contas de teste do Mercado Pago, se a plataforma estiver configurada para isso.
- Volte ao Faturamento: a fatura deve ficar Paga, com valor e data no detalhe.
Como os status do Mercado Pago aparecem na fatura
| No Mercado Pago | Na fatura |
|---|---|
| Aprovado ou autorizado | Paga |
| Pendente, em processamento ou em mediação | Aberta |
| Rejeitado, cancelado, estornado ou chargeback | Cancelada |
Atenção: um pagamento rejeitado (por exemplo, cartão recusado) marca a fatura como Cancelada. Nesse caso, gere uma nova fatura ou um novo link para o cliente tentar de novo.
Limitações do Mercado Pago no sistema
- Não há token de webhook como no Asaas: o sistema confirma cada pagamento consultando o Mercado Pago com o seu Access Token.
- Não há emissão de nota fiscal integrada. Use o modo manual em Notas fiscais (Beta).
- Só são sincronizadas as faturas geradas pelo sistema.
Perguntas frequentes
O cliente pagou e a fatura continua aberta.
Confira: 1) o link foi gerado pelo sistema? 2) o Access Token cadastrado é de produção e da mesma conta que recebeu o pagamento? 3) o endereço do sistema é público e em HTTPS? 4) o pagamento está de fato aprovado no Mercado Pago (pagamentos pendentes ou em análise continuam como Aberta)?
Preciso configurar o webhook no painel do Mercado Pago?
Em geral não: o sistema envia o endereço de aviso com cada link.
A fatura virou Cancelada depois de o cliente tentar pagar.
O Mercado Pago informou o pagamento como rejeitado ou cancelado. Gere um novo link ou uma nova fatura.
Posso usar Mercado Pago e Asaas ao mesmo tempo?
Sim. Marque um como Principal. Veja Pagamentos: como funciona a integração.
Troquei o Access Token. O que acontece com os links antigos?
Os links já gerados continuam na conta do Mercado Pago. O novo token precisa ser da mesma conta para o sistema confirmar os pagamentos antigos.