Conectar a Iugu

O que é a integração

Ao conectar a Iugu na CopyFunnel, seu checkout passa a oferecer Pix (copia e cola da fatura) e cartão de crédito tokenizado pelo iugu.js. No modelo da Iugu, tudo se resolve como fatura: o Pix é uma fatura payable_with: pix e o cartão é uma cobrança direta com token de uso único gerado no navegador do comprador (Iugu.createPaymentToken) — o dado cru do cartão nunca passa pelo servidor da CopyFunnel. O reembolso de vendas feitas pela Iugu é suportado (refund da fatura).

Onde pegar as credenciais

A Iugu usa duas credenciais:

1. Account ID — o identificador da sua conta Iugu (você o vê no endereço do painel quando está logado em alia.iugu.com — é o trecho logo depois do domínio).
2. API Token — o token de API da conta, usado pelo servidor com autenticação Basic (token como usuário, senha vazia).

Para pegar as duas:

1. Faça login no painel da Iugu (alia.iugu.com) com a conta que recebe o dinheiro.
2. Copie o Account ID da URL do painel, ou procure em Configurações da conta por "ID da conta".
3. No painel da Iugu, procure pela área de API / Tokens de API (em configurações da conta) e gere ou copie o API Token de produção — cuidado com a permissão do token (precisa permitir criação e leitura de faturas/cobranças).

Conectar na CopyFunnel

1. No painel da CopyFunnel, entre em Integrações.
2. Clique no card da Iugu (status do card: Não configurado, Configurado ou Conectado).
3. No drawer que abre, preencha:
   • Account ID (placeholder: "ID da Conta (alia.iugu.com)") — campo visível, obrigatório.
   • API Token (placeholder: "API Token da Iugu") — campo de senha, cifrado na CopyFunnel e nunca exibido de novo (só os 4 últimos dígitos).
4. Se estiver usando token de teste, marque Usar sandbox (credenciais de teste) — isso também coloca o iugu.js do checkout em modo de teste (Iugu.setTestMode). Deixe desmarcado para produção.
5. Clique em Testar conexão. O teste consulta o saldo da conta na API da Iugu (/finance/balance) — 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 o Account ID salvo — sem ele o iugu.js não tokeniza o cartão no navegador. (Boleto existe no código do driver, mas segue fora da capacidade: o boleto da Iugu exige endereço completo do pagador, que o checkout não coleta hoje.)

A confirmação de Pix usa webhook da Iugu validado por chave de autenticação (header Authorization comparado ao segredo configurado) — e nenhuma notificação aprova a venda sozinha: a CopyFunnel sempre reconfirma o status direto na API da Iugu (GET /invoices/{id}). Se a notificação atrasar, há polling automático (botão "Conferir pgto." + cron de reconciliação). Cada fatura leva o custom_variables[order_id] = ID do pedido da CopyFunnel (auditoria no painel Iugu).

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.

Dicas de erro comuns

• "Informe Account ID." — o campo visível ficou vazio ao salvar. Os dois campos são obrigatórios.
• "Informe API 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 completo, da conta certa, e confira se o token de teste está com sandbox marcado.
• Token sem permissão — o teste passa na autenticação, mas a criação de fatura falha na hora da venda com o erro da Iugu no corpo da resposta. Gere o token com permissões completas de faturas/cobranças.
• Erro na venda com mensagem da Iugu — a CopyFunnel repassa a primeira mensagem de errors da resposta da Iugu; leia-a com atenção.
• Cartão recusado logo após o comprador digitar — tokens de cartão da Iugu são de uso único e expiram com qualquer retorno: a cobrança é tentada uma vez e, se falhar, o comprador precisa refazer o pagamento (novo token).