Conectar a Woovi

O que é a integração

Ao conectar a Woovi (ex-OpenPix) na CopyFunnel, seu checkout passa a oferecer Pix com liquidação direta: a Woovi é uma Instituição de Pagamento autorizada pelo Banco Central e participante direta do SPI (conexão própria ao Pix, sem intermediário) — o valor pago cai direto na conta. O diferencial: o split da comissão acontece na própria venda — a parte da CopyFunnel é descontada pela chave Pix da plataforma no mesmo instante do pagamento (o restante fica com a conta que emitiu a cobrança). O reembolso de vendas feitas pela Woovi é suportado.

Onde pegar as credenciais

A Woovi usa uma única credencial: o AppID (Base64 de clientId:clientSecret).

1. Faça login no painel da Woovi (app.woovi.com) com a conta que recebe o dinheiro.
2. No painel, entre em Integrações / API e gere uma aplicação do tipo API — copie os valores Client_Id e Client_Secret.
3. Monte o AppID no formato Client_Id:Client_Secret (os dois valores unidos por dois-pontos) — é esse texto completo que você colará na CopyFunnel.
4. Para testar antes com valores fictícios, a Woovi oferece um ambiente sandbox (api.woovi-sandbox.com) com AppID próprio — 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 da Woovi (status: Não configurado, Configurado ou Conectado).
3. No drawer que abre, preencha o campo:
   • AppID — campo de senha: o valor é cifrado na CopyFunnel e nunca volta a ser exibido (só os 4 últimos caracteres).
4. Se estiver usando o AppID do sandbox da Woovi, 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 a conta na API da Woovi (/api/v1/account) — uma leitura barata que prova que o AppID fala com a API. Com o AppID 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 o AppID e teste novamente.

O que acontece depois

Com a conexão validada, o checkout exibe Pix (payload copia e cola na página do pedido).

O comprador paga o Pix direto na conta da Woovi da cobrança. 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 da Woovi.

Split da comissão: em contas no arranjo da plataforma, a comissão da CopyFunnel (conforme o seu plano) é enviada no campo splits da cobrança — descontada na própria venda, antes de o dinheiro chegar a qualquer parte. Esse recurso depende da funcionalidade Split ativada pela Woovi na conta emissor da cobrança.

Para finalizar, faça uma compra de teste de R$ 1,00 e confira se ela aparece em Vendas no painel com o status correto.

Perguntas frequentes

• Cartão pela Woovi? Por enquanto não: a API da Woovi emite cartão apenas à vista (o parcelamento deles é configurado só no painel da Woovi). O cartão da CopyFunnel segue pelo Asaas (fatura hospedada, com parcelas).
• Pix Automático (assinatura)? A Woovi suporta o Pix Automático (recorrência oficial do Pix); na CopyFunnel, as renovações de assinatura já funcionam por Pix comum hoje — a recorrência nativa entra em fatia futura.

Dicas de erro comuns

• "Informe AppID para conectar." — o campo ficou vazio. Deixá-lo vazio em um save posterior preserva o valor já salvo; em credencial nova não há o que preservar.
• "Falha na autenticação. Verifique as credenciais." — o AppID foi reescrito (formato errado, incompleto ou de outra conta). Monte de novo Client_Id:Client_Secret e copie o texto completo, sem espaços.
• AppID de sandbox com sandbox desmarcado (ou o contrário) — o AppID do ambiente de teste só funciona com a opção Usar sandbox marcada; o de produção, sem a marcação.
• Cobrança criada mas split recusado — a funcionalidade Split ainda não está ativada na conta Woovi que emitiu a cobrança (peça a ativação ao suporte da Woovi). Sem split, a cobrança segue funcionando: só a comissão da plataforma não é descontada na venda.