Mercado Pago
Conecte a sua conta do Mercado Pago pelo login no próprio Mercado Pago ou com as credenciais de uma aplicação.
O Mercado Pago recebe Pix, boleto e cartão. O dinheiro cai direto na sua conta do Mercado Pago, e a MinePag importa o histórico completo de pagamentos.
Duas formas de conectar
| Entrar com o Mercado Pago | Usar credenciais da aplicação | |
|---|---|---|
| Como funciona | Você autoriza a MinePag no site do Mercado Pago. | Você cola o Access Token e a Public Key de uma aplicação sua. |
| Webhook | Configurado automaticamente. | Você cadastra o endereço na aplicação e cola a assinatura secreta. |
| Renovação do acesso | Automática. | Não há renovação: as credenciais valem enquanto estiverem ativas na aplicação. |
| Quando usar | Recomendado para a maioria das lojas. | Quando você já tem uma aplicação ou prefere controlar as credenciais. |
A opção Entrar com o Mercado Pago só aparece quando está disponível no painel. Se ela não aparecer, use as credenciais da aplicação.
Conectar entrando com o Mercado Pago
No painel da loja, abra Configurações › Gateways e clique em Conectar no cartão do Mercado Pago.
Em Em qual ambiente?, escolha Produção ou Sandbox e marque Entrar com o Mercado Pago.
Em Importar vendas antigas, escolha o período (ou Não importar agora) e clique em Entrar com o Mercado Pago.
No site do Mercado Pago, entre na conta que vai receber as vendas e autorize o acesso. Você volta para a página da conexão com o aviso Gateway conectado.
O acesso concedido pelo Mercado Pago tem validade. A MinePag confere a validade todos os dias e renova o acesso quando faltam 30 dias para vencer. A página da conexão mostra Acesso renovado até com a data.
Se você revogar o acesso
Se você remover a autorização da MinePag no Mercado Pago, a renovação falha e a conexão fica como Credenciais inválidas, com a mensagem "O Mercado Pago não renovou o acesso. Conecte a conta de novo para continuar recebendo." Para trocar de conta, desconecte o gateway e conecte de novo entrando com o Mercado Pago.
Conectar com as credenciais da aplicação
Crie a aplicação
No painel de desenvolvedores do Mercado Pago, abra Suas integrações e crie uma aplicação de pagamentos online.
Copie as credenciais
Em Credenciais de produção (ou de teste, para Sandbox), copie o Access Token e a Public Key. Os dois começam com APP_USR- nas credenciais de produção e com TEST- nas de teste.
Conecte na MinePag
- Em Configurações › Gateways, clique em Conectar no cartão do Mercado Pago.
- Escolha o ambiente, marque Usar credenciais da aplicação (se a opção aparecer) e clique em Continuar.
- Cole o Access Token e a Public Key e clique em Continuar.
- Escolha o período de importação e clique em Conectar Mercado Pago.
Cadastre o webhook
Ao final, o painel avisa: "Falta cadastrar o webhook no Mercado Pago." Abra a página da conexão (Ver gateway) e siga a seção Avisos de pagamento (webhook):
- No painel de desenvolvedores do Mercado Pago, abra a sua aplicação e entre em Webhooks › Configurar notificações.
- Copie a URL do webhook da página da conexão e cole no modo correspondente ao ambiente (produção ou teste).
- Marque os eventos Order (Mercado Pago), Pagamentos e Contestações e salve. Sem Contestações, a MinePag só descobre um chargeback na consulta diária.
- Copie a assinatura secreta gerada pelo Mercado Pago, cole em Assinatura secreta na MinePag e clique em Salvar assinatura.
A URL do webhook tem este formato, com o identificador da sua conexão:
https://minepag.com.br/api/webhooks/payments/mercadopago/<id-da-conexão>Copie sempre a URL exibida no painel, que já vem completa.
Sem a assinatura secreta, a confirmação atrasa
Enquanto a assinatura secreta não for salva, a MinePag não aceita os avisos do Mercado Pago e confirma os pagamentos pela consulta periódica, com alguns minutos de atraso. O cliente espera mais para receber o que comprou.
Se você gerar uma nova assinatura no Mercado Pago, cole a nova em Assinatura secreta e salve de novo.
Ambientes
- Produção só aceita credenciais de produção. Um Access Token
TEST-é recusado com a mensagem "Esse Access Token é de teste. Use as credenciais de produção para o ambiente Produção." - O Access Token e a Public Key precisam ser do mesmo ambiente.
Veja como testar em Sandbox e Produção.
Reembolsos
Pix, boleto e cartão podem ser reembolsados pela MinePag, no valor total ou em parte. O Mercado Pago aceita reembolsos por até 180 dias depois da aprovação, e o valor sai do saldo da sua conta: sem saldo suficiente, o reembolso é recusado. Veja Reembolsos e contestações.
Importação de histórico
A MinePag busca todos os pagamentos da conta no período escolhido, de qualquer forma de pagamento. Veja Importação de histórico.
Trocar credenciais
Com credenciais da aplicação, use Atualizar credenciais na página da conexão. A MinePag recusa credenciais de outra conta do Mercado Pago: para mudar de conta, desconecte e conecte de novo.
Com o login pelo Mercado Pago, não há credenciais para trocar. O acesso é renovado sozinho.
Mensagens de erro
| Mensagem | Como resolver |
|---|---|
| Access Token do Mercado Pago inválido. | Cole o Access Token completo, começando com APP_USR- ou TEST-. |
| O Mercado Pago recusou o Access Token. | Gere de novo as credenciais na aplicação e cole as novas. |
| O Access Token não tem permissão para consultar pagamentos. Gere credenciais de produção da aplicação. | Use as credenciais de produção da aplicação, não as de um usuário de teste sem permissão. |
| O Access Token e a Public Key precisam ser do mesmo ambiente. | Copie os dois da mesma aba (produção ou teste). |
| A autorização no Mercado Pago foi cancelada. Nada foi conectado. | Você saiu do site do Mercado Pago sem autorizar. Tente de novo. |
| Esta loja já tem o Mercado Pago conectado nesse ambiente. | Cada loja aceita uma conexão por ambiente. Atualize a conexão existente ou desconecte antes. |
Mais casos em Problemas comuns.