Conectar o Pagar.me
Ao final deste guia sua loja recebe por Pix, cartão e boleto — com o cliente pagando sem sair do seu site.
O Pagar.me é o caminho mais curto pra começar a vender: conecta em um clique, sem você copiar chave nenhuma.
Onde fica: Meios de pagamento → card Pagar.me → Conectar.
O jeito fácil: um clique
- Clique em Conectar com Pagar.me.
- Você autoriza na tela do próprio Pagar.me.
- Pronto. A tela passa a mostrar "Conectada via 1 clique — tudo pronto pra receber com Pix, cartão e boleto".
Você não vê nem digita chave nenhuma. A renovação do acesso é automática.
O jeito manual: colando as chaves
Só precisa disso se você já tem conta Pagar.me e prefere usar as suas próprias credenciais. A tela explica cada uma, e vale repetir aqui porque a confusão entre elas é comum:
| Credencial | O que ela faz |
|---|---|
| ID da conta | Identifica sua conta e associa as transações ao seu CNPJ |
| Chave pública | Protege o cartão no checkout: os dados viram um código antes de sair do navegador do cliente |
| Chave da API | Autoriza a cobrança e o estorno. Fica só no servidor — nunca no navegador |
⚠️ Teste e produção são chaves diferentes. Em teste, nada é cobrado de verdade: serve pra você conferir o fluxo. Antes de abrir a loja, troque pelas chaves de produção — a tela avisa em qual ambiente você está.
As configurações avançadas
Ficam no bloco Configurações avançadas, e nenhuma é obrigatória pra começar:
- Parcelas — em até quantas vezes o cliente pode dividir, e até qual parcela sem juros. O juro das parcelas sem juros sai do seu bolso: parcelar em 3x sem juros costuma aumentar a conversão, mas reduz a margem. Faça a conta.
- Juros por parcela — a tabela que aparece logo abaixo, uma linha por parcela que cobra juros. 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 em português embaixo de cada campo, enquanto você digita.
⚠️ Duas travas, pra evitar erro caro: a tela não salva com célula em branco — em branco não é "não ofereço", é "ofereço de graça", e o custo fica com você (use 0 se aquela parcela não tem juros). E o juro não pode diminuir quando a parcela aumenta: cobrar menos por 12x do que por 6x é sempre engano de digitação, e o erro só aparece na fatura do cliente.
- Valor mínimo da parcela — evita parcela de R$ 8.
- Validade do Pix — quanto tempo o código fica de pé antes de expirar.
- Prazo do boleto — em quantos dias vence.
- Nome na fatura — o que aparece no extrato do cartão do cliente. Use algo que ele reconheça, senão vira contestação.
Deu errado?
| O que aconteceu | Por quê | Como resolver |
|---|---|---|
| A tela diz Conectado · Teste | Você está com credenciais de teste | Troque pelas de produção — em teste não entra dinheiro de verdade |
| O cliente diz que a compra falhou | Pode ser recusa do emissor, não da loja | Conecte um segundo gateway como contingência: se o principal recusar, a cobrança tenta no outro |
| Quero trocar de conta | Use Desconectar e conecte de novo com a outra conta |
E agora?
- Conectar o Mercado Pago — vale como contingência
- Passo 4 — Meios de pagamento (a visão geral)