Integração com o Mercado Pago: Pix, boleto e cartão
Como criar a aplicação de Checkout Transparente, preencher a Public Key e o Access Token e cadastrar o webhook para receber Pix, boleto e cartão pelo Mercado Pago.
O que é
Com a integração com o Mercado Pago, a sua conta Mercado Pago recebe os pagamentos online dos seus clientes por Pix, boleto e cartão de crédito: pedidos, recargas de carteira e faturas. O pagamento é confirmado sozinho, sem conferência manual.
O Mercado Pago não é usado para pagar os saques dos entregadores. Para isso, veja Repasses automáticos.
Antes de começar
- Conta no Mercado Pago (de preferência de empresa, com CNPJ).
- Acesso ao painel de desenvolvedor do Mercado Pago (Suas integrações), com o mesmo login da conta.
- No Entregas Expressas, um usuário com acesso a Configurações › Pagamento Online.
1. Crie a aplicação no Mercado Pago
- No painel de desenvolvedor do Mercado Pago, abra Suas integrações e crie uma aplicação.
- Quando o Mercado Pago perguntar o tipo de solução, escolha pagamentos online com Checkout Transparente. Aplicação de outro tipo (Checkout Pro, link de pagamento, maquininha) é recusada pela plataforma ao salvar.
- Na aplicação, abra Credenciais de produção e copie a Public Key e o Access Token.
Use as credenciais de produção. Credenciais de teste (que começam com TEST-) não são aceitas, e a tela não grava o Access Token.
2. Preencha as credenciais no painel
- No painel, vá em Configurações › Pagamento Online.
- Para o Pix: marque Ativar PIX e, em Gateway de Pagamento Pix, escolha Mercado Pago.
- Preencha Public Key Mercado Pago e Access Token Mercado Pago.
- Repita no bloco do boleto e no do cartão de crédito, conforme as formas que você quer oferecer. Pode ser a mesma aplicação nos três.
- Clique em Salvar. A plataforma confere a credencial com o Mercado Pago na hora de salvar.
3. Cadastre o webhook no Mercado Pago
O webhook avisa a plataforma que o cliente pagou. Sem ele, o pagamento entra na sua conta Mercado Pago, mas nada é confirmado no painel, e nenhum erro aparece.
- Na tela de Pagamento Online, copie a URL do WebHook Mercado Pago (botão ao lado do campo).
- No painel de desenvolvedor do Mercado Pago, na sua aplicação, abra Webhooks e escolha Modo de produção.
- Cole a URL e marque o evento que a tela do painel indica embaixo da URL. Em conta configurada agora, é Order (Mercado Pago).
- Salve no Mercado Pago. Ele gera uma assinatura secreta: copie-a.
- De volta ao painel, cole em Assinatura secreta do webhook e clique em Salvar.
Marque só o evento que a tela indica. Embaixo da URL, a tela também mostra a Integração em uso. Contas configuradas há mais tempo continuam em Pagamentos (legacy), e nelas o evento a marcar é o de pagamentos.
Pix, boleto e cartão podem ficar em contas Mercado Pago diferentes. Nesse caso, cada conta tem o seu webhook e a sua assinatura: cadastre a URL em cada uma.
Como fica para o seu cliente
- Pix: ele recebe o QR Code e o código copia e cola.
- Boleto: ele recebe o boleto para pagar. O Mercado Pago exige o endereço de quem paga, então confira o endereço no cadastro do cliente.
- Cartão de crédito: ele digita os dados do cartão, inclusive o código de segurança, na tela de pagamento do Portal B2B.
Onde ele paga: no lançamento do pedido, na linha Pagamento (grupo Pagar agora, só Pix e cartão; o boleto não paga pedido), em Carteira › Adicionar Saldo e em Faturas › Detalhes. Passo a passo do lado do cliente em Pagar pedido no Portal B2B, Carteira no Portal B2B e Faturas no Portal B2B; avisos de erro em Mensagens de erro do Portal B2B: pagamento.
No app do entregador
- Pedido pago online: a forma de pagamento aparece com o nome do gateway, e o entregador não cobra nada na entrega. Para esconder essa informação, ligue Ocultar forma de pagamento em pagamentos online.
Quem pode usar
Em Perfis de Acesso, a permissão é Configurações de pagamentos online. O administrador já vem com ela.
Perguntas frequentes
O cliente pagou, mas o pedido continua como não pago.
Confira o webhook no Mercado Pago: modo de produção, a URL copiada da tela e o evento indicado embaixo dela. Esse é o motivo mais comum.
Salvei, mas o Access Token não ficou gravado.
O Mercado Pago recusou a credencial. Confira se ela é de produção (não TEST-) e se a aplicação é de Checkout Transparente. Se a aplicação for de outro tipo, crie uma nova do tipo certo.
O cartão do cliente foi recusado.
A recusa vem do Mercado Pago ou do banco do cartão. Peça ao cliente para conferir os dados ou usar outro cartão. Se acontecer com todos os cartões, recarregue a página de pagamento e tente de novo.
Dá para pagar os entregadores pelo Mercado Pago?
Não. O repasse aos entregadores sai pelo Asaas, Inter, Sicoob ou Cora. Veja Repasses automáticos.
