Conectar o Mercado Pago
Ao final deste guia sua loja aceita Pix, cartão e boleto pelo Mercado Pago — como gateway principal ou como rede de segurança do outro.
Onde fica: Meios de pagamento → card Mercado Pago → Conectar.
Se você já tem outro gateway, este vira a contingência
A própria tela avisa quando isso acontece, e é o melhor motivo pra conectar um segundo:
Se o principal recusar ou cair, a cobrança tenta aqui automaticamente.
Recusa de cartão é comum e nem sempre é culpa do cliente — cada adquirente tem seu próprio critério. Com dois gateways, a venda que morreria na primeira recusa tem uma segunda chance, sem o cliente perceber.
O jeito fácil: um clique
- Clique em Conectar com Mercado Pago.
- Autorize na tela do Mercado Pago.
- Pronto — sem copiar Access Token nem Public Key.
O jeito manual: colando as credenciais
| Credencial | O que é |
|---|---|
| Public Key | Protege o cartão no checkout. Começa com APP_USR- (produção) ou TEST- (teste) |
| Access Token | Autoriza a cobrança e o estorno. Fica só no servidor |
| ID da conta | Opcional — um apelido pra você identificar esta integração |
⚠️ Confira o ambiente antes de salvar. A tela mostra Ambiente de teste ou Produção e avisa: em produção, as transações são cobranças reais. Credencial de teste em produção = venda que não entra.
As opções que valem olhar
- Exigir 3DS — a verificação extra do banco no cartão. Reduz fraude e contestação; em compensação, adiciona um passo pro cliente.
- Juros por parcela — o número é quanto a compra fica mais cara no total, não é ao mês:
12numa compra de R$ 100 vira R$ 112, em 12x de R$ 9,33. A tela mostra essa conta embaixo de cada campo enquanto você digita, não salva com célula em branco (use0se não tem juros) e não deixa o juro diminuir quando a parcela aumenta. - Parcelas, valor mínimo, validade do Pix, prazo do boleto e nome na fatura — iguais aos do outro gateway. O nome na fatura é o que mais gera contestação quando o cliente não reconhece.
Deu errado?
| O que aconteceu | Por quê | Como resolver |
|---|---|---|
| A conexão de 1 clique não conclui | A autorização foi cancelada ou expirou | Tente de novo; se persistir, use as credenciais manuais |
| Pagamentos recusados em série | Credencial de teste em ambiente de produção | Confira o aviso de ambiente no topo da tela |
| Conectei mas não vira principal | Já existe um principal | É esperado: o segundo entra como contingência. Pra trocar, ajuste qual é o principal em Meios de pagamento |