Como gerar um link de KYC ou usar o KYC direto na plataforma

Para abrir uma nova conta virtual (Baas) na Woovi, é preciso completar o KYC do cliente. Hoje você tem duas formas de fazer isso pela plataforma:

• KYC na plataforma — o cliente preenche o KYC dentro do seu próprio painel da Woovi (em iframe). Útil quando você quer manter o cliente dentro do ambiente da sua empresa.

• Gerar link de integração — você gera um link único e compartilha com o cliente (e-mail, WhatsApp, ticket de atendimento). O cliente abre o link em qualquer dispositivo e completa o KYC por conta própria.

Os dois caminhos terminam no mesmo formulário de KYC e geram o mesmo AccountRegister no backend — a diferença é onde o cliente vai preencher.

Onde fica o botão

O botão Nova Conta Baas fica na página Contas → Lista de contas, no canto superior direito:

Pré-requisitos: features necessárias

Para o botão aparecer e abrir o fluxo de duas etapas (com escolha entre embed e link), sua empresa precisa ter estas features ativadas:

| Feature | Para que serve |
|---|---|
| BAAS | Habilita o botão Nova Conta Baas na página de Contas. Sem essa feature, o botão não aparece. |

Não vê o botão ou só vê o fluxo antigo? Fale com o seu gerente de contas Woovi, ou abra um ticket em [email protected] pedindo a ativação das features acima.

Onde criar uma nova conta virtual

1. No menu lateral, acesse Contas → Lista de contas

2. Clique em Nova Conta Baas no canto superior direito

3. Um modal de duas etapas abre

Etapa 1 — Informe o CNPJ

Informe o CNPJ da empresa que vai abrir a conta virtual. O botão Continuar só fica ativo depois de digitar um CNPJ válido.

💡 O link gerado é idempotente por CNPJ: se você já criou um link para esse CNPJ antes, gerar de novo retorna o link existente — o cliente continua de onde parou.

Etapa 2 — Escolha como o KYC vai ser feito

Duas opções aparecem:

| Opção | Quando usar |
|---|---|
| KYC na plataforma | Você quer que o cliente preencha o KYC sem sair da sua plataforma. Abre o KYC em iframe dentro do seu painel. |
| Gerar link de integração | Você quer enviar o link por outro canal (e-mail, WhatsApp, ticket) para o cliente preencher quando puder. |

Opção A — KYC na plataforma

Ao clicar em KYC na plataforma, a plataforma redireciona automaticamente para a tela de embed, com o KYC já carregado dentro do seu painel:

O cliente preenche todas as etapas do KYC sem sair da sua plataforma. No topo direito, o botão Abrir em nova aba permite expandir a visualização — útil quando o cliente vai preencher o KYC ele mesmo, sem você ao lado.

Opção B — Gerar link de integração

Ao clicar em Gerar link de integração, o sistema cria/recupera o link e exibe na próxima etapa do modal:

Você pode:

• Copiar o link com um clique no botão Copiar link

• Compartilhar com o cliente pelo canal que preferir (e-mail, WhatsApp, sistema de tickets, intranet, etc.)

• Reutilizar: o mesmo link pode ser enviado várias vezes — não expira a cada uso, e o cliente continua de onde parou se reabrir

O formato da URL é: https://app.woovi.com/kyc/onboarding/<id> (na produção; em ambientes de teste, o domínio pode variar).

Como o cliente preenche o KYC

Independente do fluxo escolhido, o cliente passa pelas mesmas 7 etapas:

1. Início — boas-vindas

2. Dados da Empresa — confirmar CNPJ e descrição do negócio

3. Endereço — endereço da empresa

4. Contrato Social — upload do contrato

5. Sócios e Documentos — dados, selfie, documentos, autenticação Pix e verificação BC PROTEGE+ de cada sócio

6. Termos — aceite dos termos

7. Revisão — confirmação final e envio

Idempotência e reuso

• O link é idempotente por CNPJ: gerar duas vezes para o mesmo CNPJ retorna o mesmo AccountRegister. Não cria duplicatas.

• O link é reutilizável: pode ser aberto várias vezes pelo cliente (no mesmo dispositivo ou em outro). O progresso é salvo a cada etapa.

• Cada acesso é registrado (data e contagem) — você pode acompanhar se o cliente já abriu o link.

• O link não expira automaticamente. A conta só fecha após o KYC ser concluído e aprovado.

Quando usar cada opção

| Situação | Recomendado |
|---|---|
| Cliente está com você (presencial, ligação, vídeo) | KYC na plataforma |
| Cliente vai preencher quando tiver tempo | Gerar link de integração |
| Cliente está em outro dispositivo (celular) | Gerar link de integração |
| Você quer monitorar o cliente preenchendo | KYC na plataforma |
| Você gerencia muitos onboardings simultâneos | Gerar link de integração |

Em caso de dúvidas

Se o cliente reportar problemas para abrir o link, ou alguma etapa do KYC ficar travada (especialmente a verificação BC PROTEGE+), consulte:

• Quanto tempo esperar para refazer a verificação do BC PROTEGE+ no onboarding?

• Como ativar e desativar o BC PROTEGE+

Para outros casos, escreva para [email protected].