Como ocultar a logo da Woovi no link de onboarding?
Ao incorporar o KYC Onboarding no seu produto (via iframe, redirecionamento ou popup), você pode querer uma experiência white-label, sem a logo da Woovi no topo da página.
Para isso, o formulário tem um modo embedded: basta adicionar o parâmetro de query ?embed=true à URL de onboarding. Quando presente, o cabeçalho com a logo da Woovi não é exibido.
O modo embedded é controlado pela própria URL. Não há configuração de conta, feature ou chamada de API extra para ativá-lo — é só o parâmetro ?embed=true. Você pode aplicá-lo a qualquer linkOnboarding.
O que o ?embed=true oculta (e o que não oculta)
| Elemento | Com ?embed=true |
|---|---|
| Cabeçalho com a logo da Woovi (topo da página) | Ocultado |
| Formulário multi-step (dados, endereço, sócios, documentos, termos) | Inalterado |
| Texto contratual ("WOOVI INSTITUIÇÃO DE PAGAMENTO LTDA." nos Termos) | Mantido — é conteúdo regulatório e não pode ser removido |
| Link "termos de uso e política de privacidade da Woovi" | Mantido |
Título da aba do navegador (Woovi | KYC) | Inalterado |
O ?embed=true remove apenas o elemento visual de branding (a logo no cabeçalho). As menções contratuais à Woovi nos Termos de Abertura de Conta são obrigatórias por regulação (BACEN) e permanecem no documento.
Como aplicar
O linkOnboarding retornado pela API POST /api/v1/kyc/onboarding vem sem o parâmetro. Para o modo white-label, basta anexá-lo ao link que você recebeu:
https://kyc.woovi.com/onboarding/QWNjb3VudFJlZ2lzdGVyOjY5...?embed=true
Se a URL já tiver uma query string, use &embed=true em vez de ?embed=true. Ex.: ...?foo=bar&embed=true.
- Iframe
- JavaScript
<iframe
src="https://kyc.woovi.com/onboarding/QWNjb3VudFJlZ2lzdGVyOjY5...?embed=true"
width="100%"
height="900"
style="border: 0; max-width: 640px;"
title="Cadastro KYC"
allow="camera; clipboard-read; clipboard-write"
></iframe>
// linkOnboarding recebido do seu backend (sem embed)
const url = new URL(data.linkOnboarding);
url.searchParams.set('embed', 'true');
// Redireciona / abre em modo white-label
window.location.href = url.toString();