Conectar o PagSeguro (PagBank)

O que é a integração

Ao conectar o PagSeguro/PagBank na CopyFunnel, seu checkout passa a oferecer Pix (QR Code + copia e cola) e cartão de crédito tokenizado pela API Orders do PagBank. O cartão é criptografado no navegador do comprador com a sua Chave RSA pública (SDK PagSeguro.encryptCard) — o dado cru do cartão nunca passa pelo servidor da CopyFunnel. O reembolso de vendas feitas pelo PagSeguro é suportado (cancelamento da cobrança).

Onde pegar as credenciais

O PagSeguro/PagBank usa duas credenciais:

1. Chave RSA pública — a chave pública da sua aplicação no PagBank, usada para criptografar o cartão no navegador.
2. Token (Access Token) — token Bearer da sua aplicação, usado pelo servidor para criar e consultar pedidos.

Para pegar as duas:

1. Acesse o portal de desenvolvedores do PagBank (dev.pagbank.uol.com.br) com a sua conta PagBank/PagSeguro — a mesma que recebe o dinheiro.
2. No painel, procure pela área de Aplicações (ou "Aplicação") e abra a aplicação da sua operação — ou crie uma nova.
3. Na aplicação, copie a Chave pública (Public Key) e o Token de acesso de produção. Se o caminho tiver outro nome na sua conta, procure por "chaves" ou "credenciais" dentro da aplicação.

Conectar na CopyFunnel

1. No painel da CopyFunnel, entre em Integrações.
2. Clique no card do PagSeguro (status do card: Não configurado, Configurado ou Conectado).
3. No drawer que abre, preencha:
   • Public Key (placeholder: "Chave RSA pública (painel PagBank)") — campo visível, obrigatório.
   • Token (placeholder: "Access Token do PagBank") — campo de senha, cifrado na CopyFunnel e nunca exibido de novo (só os 4 últimos dígitos).
4. Se estiver usando credenciais do sandbox do PagBank, marque Usar sandbox (credenciais de teste) — isso troca a base da API para o ambiente de teste. Deixe desmarcado para produção.
5. Clique em Testar conexão. O teste lista pedidos da conta (GET /orders) — leitura barata que prova que o token autentica. Com o token válido 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 Chave RSA pública salva — sem ela a CopyFunnel não criptografa o cartão no navegador. (Boleto existe no código do driver, mas segue fora da capacidade: o boleto registrado do PagBank exige endereço do comprador, que o checkout não coleta hoje.)

A confirmação de Pix usa webhook validado por token de autenticidade (x-authenticity-token, SHA-256 de {token}-{corpo}) — e nenhuma notificação aprova a venda sozinha: a CopyFunnel sempre reconfirma o status direto na API do PagBank. 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. O pedido leva o reference_id = ID do pedido da CopyFunnel (auditoria no painel PagBank).

Dicas de erro comuns

• "Informe Public Key." — o campo visível ficou vazio ao salvar. Os dois campos são obrigatórios.
• "Informe Token para conectar." — o segredo ficou vazio. Deixá-lo vazio em um save posterior preserva o token já salvo.
• "Falha na autenticação. Verifique as credenciais." — o token foi rejeitado (HTTP 401). Copie o token de produção da aplicação certa, sem espaços, e confira se o sandbox está marcado só para credenciais de teste.
• "PAGSEGURO createPix sem copia-e-cola (qr_codes)." — a API não devolveu o QR do Pix. Confira se o Pix está habilitado na conta PagBank.
• Descrição do erro na resposta — a CopyFunnel repassa a primeira error_messages[].description do PagBank; leia-a com atenção (geralmente diz exatamente qual campo falhou).
• Pedido preso em pendente com pagamento em análise — status IN_ANALYSIS do PagBank é risco/antifraude pendente: permanece pendente até o PagBank aprovar; a CopyFunnel reconfirma via webhook/polling.
• Cartão não aparece no checkout — confira se a Chave RSA pública foi salva; sem ela não há criptografia do cartão no navegador.