Conectar o Asaas

O que é a integração

Ao conectar o Asaas na CopyFunnel, seu checkout passa a oferecer Pix (QR Code + copia e cola), boleto e cartão de crédito pela API do Asaas. No cartão, o pagamento acontece pela fatura hospedada do Asaas (redirecionamento): o comprador digita os dados do cartão na página protegida da própria Asaas — nenhum dado de cartão passa pelo CopyFunnel. O reembolso de vendas feitas pelo Asaas é suportado.

Onde pegar as credenciais

O Asaas usa uma única credencial: a API Key (chave de API da sua conta).

1. Faça login no painel do Asaas (asaas.com) com a conta que recebe o dinheiro.
2. No painel do Asaas, procure pela área de API / Integrações (geralmente em Configurações do sistema) e copie a Chave de API de produção.
3. Se quiser testar antes com dinheiro fictício, o Asaas também oferece um ambiente sandbox (api-sandbox.asaas.com) com a própria chave — use-o junto com a opção de sandbox na CopyFunnel.

Conectar na CopyFunnel

1. No painel da CopyFunnel, entre em Integrações.
2. Clique no card do Asaas (status do card: Não configurado, Configurado ou Conectado).
3. No drawer que abre, preencha o único campo:
   • API Key (placeholder: "API Key do Asaas") — campo de senha: o valor é cifrado na CopyFunnel e nunca volta a ser exibido (só os 4 últimos dígitos).
4. Se estiver usando a chave do sandbox do Asaas, 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 consulta o saldo da conta na API do Asaas (/finance/balance) — uma leitura barata que prova que a chave fala com a API. 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 a chave e teste novamente.

O que acontece depois

Com a conexão validada, o checkout exibe Pix e boleto:

• Pix: a CopyFunnel cria a cobrança e busca o QR Code (payload copia e cola + imagem) na hora.
• Boleto: nasce pendente e compensa em 1–3 dias úteis; linha digitável e código de barras ficam na página do pedido.

O comprador precisa informar CPF/CNPJ para Pix e boleto no Asaas — a CopyFunnel cria o cliente (customer) na sua conta Asaas por documento, reutilizando se já existir. Se o webhook de confirmação não chegar, a venda é confirmada por polling automático (botão "Conferir pgto." + cron de reconciliação); nenhuma notificação aprova a venda sozinha — a CopyFunnel sempre reconfirma o status direto na API do Asaas.

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 API Key para conectar." — o campo ficou vazio. Deixá-lo vazio em um save posterior preserva a chave já salva; em credencial nova não há o que preservar.
• "Falha na autenticação. Verifique as credenciais." — a API Key foi rejeitada (chave errada, incompleta ou de outra conta). Copie novamente do painel do Asaas, sem espaços.
• Chave de sandbox com sandbox desmarcado (ou o contrário) — a chave da API de teste só funciona com a opção Usar sandbox marcada; a de produção, sem a marcação. O teste falha se os dois estiverem dessincronizados.
• Erro em "customer" na hora da venda — o documento informado pelo comprador é inválido (CPF/CNPJ com dígitos errados). A mensagem exibida vem direto do Asaas; revise o checkout/formulário ou peça para o comprador corrigir o documento.
• Cartão abre uma página da Asaas — esperado: a integração Asaas usa a fatura hospedada deles no cartão (o comprador conclui lá e volta ao checkout; a confirmação aparece no pedido sozinha).