Conectar o Pagar.me

O que é a integração

Ao conectar o Pagar.me na CopyFunnel, seu checkout passa a oferecer Pix (QR Code copia e cola) e cartão de crédito tokenizado. O número do cartão é tokenizado no navegador do comprador (endpoint /tokens do Pagar.me, com a Public Key — sem dado cru passando pelo servidor da CopyFunnel) e o servidor confirma a cobrança só com o token. O reembolso de vendas feitas pelo Pagar.me é suportado (cancelamento da cobrança — no Pix, o cancelamento estorna).

Onde pegar as credenciais

O Pagar.me usa duas credenciais:

1. Public Key (pk_...) — chave pública usada para tokenizar o cartão no navegador do comprador.
2. Secret Key (sk_...) — chave secreta usada pelo servidor (a autenticação da API é Basic: Secret Key como usuário, senha vazia).

Para pegar as duas:

1. Faça login no painel do Pagar.me (dashboard.pagar.me) com a conta que recebe o dinheiro.
2. No painel, procure pela área de Desenvolvedor / Chaves de API.
3. Copie a Public Key e a Secret Key de produção — as chaves começam com pk_ e sk_ (chaves de teste começam com pk_test_/sk_test_ e só funcionam em modo de teste).

Conectar na CopyFunnel

1. No painel da CopyFunnel, entre em Integrações.
2. Clique no card do Pagar.me (status do card: Não configurado, Configurado ou Conectado).
3. No drawer que abre, preencha:
   • Public Key (placeholder: "Public Key (pk_...)") — campo visível, obrigatório.
   • Secret Key (placeholder: "Secret Key (sk_...)") — campo de senha, cifrado na CopyFunnel e nunca exibido de novo (só os 4 últimos dígitos).
4. Se estiver usando chaves sk_test_, marque Usar sandbox (credenciais de teste) — desmarque para produção. Obs.: o próprio prefixo da Secret Key decide o ambiente na API do Pagar.me.
5. Clique em Testar conexão. O teste lista cobranças da conta (limite 1) na API v5 do Pagar.me — leitura barata que prova que a Secret Key autentica. Com a chave válida aparece "Conexão realizada com sucesso."
6. Clique em Salvar. Ao salvar, a conexão é testada de novo: com sucesso você vê "Credenciais salvas e conexão verificada." e o card passa a Conectado.

Só a credencial Conectado entra no checkout. Se o teste falhar ao salvar, a credencial fica Configurado — corrija e teste novamente.

O que acontece depois

Com a conexão validada, o checkout exibe Pix e cartão. O botão de cartão só aparece com a Public Key salva — sem ela a CopyFunnel não tokeniza o cartão no navegador. (Boleto existe no código do driver, mas segue fora da capacidade: o boleto do Pagar.me exige endereço do comprador, que o checkout não coleta hoje.)

A confirmação de Pix usa webhook do Pagar.me validado por assinatura HMAC-SHA256 (X-Hub-Signature-256) — e nenhuma notificação aprova a venda sozinha: a CopyFunnel sempre reconfirma o status direto na API do Pagar.me. Se a notificação atrasar, há polling automático (botão "Conferir pgto." + cron de reconciliação).

Para finalizar, faça uma compra de teste de R$ 1,00 (Pix é o mais rápido de validar) e confira se ela aparece em Vendas no painel com o status correto. No painel do Pagar.me, o pedido aparece com o code = ID do pedido da CopyFunnel (auditoria).

Dicas de erro comuns

• "Informe Public Key." — o campo visível ficou vazio ao salvar. Os dois campos são obrigatórios.
• "Informe Secret Key para conectar." — o segredo ficou vazio. Deixá-lo vazio em um save posterior preserva a chave já salva.
• "Falha na autenticação. Verifique as credenciais." — a Secret Key foi rejeitada (HTTP 401 da API). Confira se copiou a chave completa, da conta certa, e se sk_test_ combina com a opção de sandbox marcada.
• Public e Secret de ambientes diferentes — pk_live_ com sk_test_ (ou o contrário) quebra a tokenização no navegador: o teste de conexão pode passar, mas o botão de cartão falha na hora da venda. Use o par do mesmo ambiente.
• "PAGARME pix → resposta sem qr_code." — a conta não retornou o QR do Pix. Verifique se o Pix está habilitado na sua conta Pagar.me.
• Cartão recusado com motivo da operadora — a mensagem da adquirente (acquirer_message) aparece para o comprador; é recusa real do emissor, não erro de integração.