Principal Onboarding

Onboarding

Conhecendo a plataforma e suas funcionalidades
Sibelius Seraphini Gabriel Hofferman
Por Sibelius Seraphini and 2 outros
• 13 artigos

Criando um usuário

Se você deseja conceder acesso a plataforma aos seus funcionários, saiba que é possível criar perfis de usuários individuais na plataforma e gerenciar as permissões de acesso concedidas a cada um. Para criar os perfis de usuários, siga as orientações abaixo: Faça login na sua conta: Login OpenPix Logado em sua conta de administrador da plataforma, clique em "Usuários/Permissões" A tela de Usuários abrirá. Clique em "Adicionar usuário" Ao clicar em adicionar a usuário, a tela "Criar novo usuário" abrirá. Preencha os campos com os dados do usuário que você deseja criar e depois clique em "Salvar" || É possível criar um novo usuário utilizando: apenas e-mail; e-mail e celular; CPF e e-mail; CPF e celular. Em casos em que não haja e-mail cadastrado, o usuário receberá sua solicitação de redefinição de senha via SMS. Após clicar em salvar, o usuário já estará criado na plataforma e você será direcionado para a tela com as informações do mesmo. O usuário receberá em seu e-mail, cadastrado na plataforma, uma solicitação de redefinição de senha. Caso não haja e-mail cadastrado, ele receberá essa solicitação por SMS. Por isso, é importante que o celular cadastrado esteja correto. Após realizar a redefinição de senha, basta que o usuário tenha sempre em mãos suas informações de login para acessar a plataforma. || Para informações sobre como logar na plataforma, clique no link: Como fazer login na plataforma Finalizado a criação do usuário, clicando em "permissões", você já poderá configurar as permissões de acesso do mesmo. || Para informações sobre como configurar permissões de acesso, clique no link: Gerenciando permissões Ah! não cobramos por usuários criados, então fique à vontade para criar quantos forem necessários, pois, recomendamos que as informações de login não sejam compartilhadas, mas, que antes, cada um possua o seu acesso.

Última atualização em Jan 08, 2026

Como Criar uma Cobrança

É novo na plataforma e não sabe como criar uma cobrança?! Calma, que a OpenPix te ajuda! Com a plataforma aberta clique em “Home” Com a Home da sua plataforma aberta clique em “Nova Cobrança” Uma página para a criação da cobrança abrirá Comece a preencher os dados da cobrança. 1) Escolha se será uma cobrança pix comum ou uma cobrança com juros e multa || Para saber mais sobre cobranças com juros e multa, clique no link: Cobrança pix com vencimento, juros e multa 2) Selecione o cliente que será cobrado Se quiser linkar a cobrança a algum cliente em específico, clique em “Selecionar”, caso você queira vincular a cobrança a algum cliente específico mas não o tenha cadastrado na plataforma, clique em “Criar” e crie o seu cliente; se não quiser vincular a cobrança a nenhum cliente, selecione a opção "Autocasdastro". Nessa opção o nome e CPF/CNPJ do cliente serão cadastrados automaticamente após o pagamento. 3) Dados da Cobrança Após isso, preencha os dados dessa cobrança, colocando o valor e uma breve descrição do pagamento - nessa descrição você poderá colocar uma descrição do produto ou do serviço adquirido pelo seu cliente ou a ordem de pagamento. Porém, caso não queira realizar uma descrição do pagamento, não tem problema. O único quesito indispensável é que você insira no campo "Valor" o valor da cobrança que está criando. 4) Cashback Apenas ative esse campo caso deseje oferecer ao seu cliente Cashback, em cima do valor da compra atual. || Para saber mais sobre o Cashback e como habilitá-lo, clique no link: Como habilitar o cashback 5) Informações adicionais Nessa etapa você pode adicionar alguns dados da cobrança que o cliente poderá ver quando for pagar o QR Code. Você pode colocar alguma informação sobre o pedido do cliente para que ele saiba que está pagando o pedido correto. Esse é um passo opcional, caso não queira, não precisa realizá-lo 6) Notificações Nessa parte, você terá a opção de enviar essa cobrança via e-mail para o seu cliente e também de enviar, via e-mail, um recibo do pagamento. Essa parte é opcional. Note que para habilitar os envios mencionados, será necessário ter um cliente linkado a cobrança com e-mail cadastrado. 7) Tempo para pagamento Aqui você irá definir o tempo que o cliente terá para efetuar o pagamento dessa cobrança. Lembrando que se o seu cliente não efetuar o pagamento dentro do prazo, a cobrança irá expirar e será necessário gerar uma nova cobrança. 8 ) Área Vinculada Se você possui diferentes canais de venda, regiões ou áreas de negócios e precisa monitorar de forma separada as cobranças de cada um desses canais você deve utilizar a funcionalidade Áreas. || Para saber mais sobre as Áreas, clique no link: O que é a funcionalidade Áreas 9) Destino do pagamento Nessa parte você poderá visualizar as informações da sua conta virtual para onde o pagamento dessa cobrança irá. Após isso, clique em "Criar Cobrança" e logo você será redirecionado para uma página contendo o QR Code para o pagamento da cobrança, semelhante a esta: Agora é só enviar a cobrança criada para o seu cliente!

Última atualização em Jan 08, 2026

Como habilitar o Cashback

Para habilitar o Cashback em seu painel siga as orientações abaixo: Faça login em sua conta: Login OpenPix Após logar em sua conta, clique em "Cashback" A tela com informações sobre o Cashback e o Cashback Fidelidade, abrirá. Nesse momento você deverá escolher qual dos cashbacks disponíveis, deseja ativar. Caso queira, também é possível ativar os dois em sua conta. Habilitar Cashback Para habilitar o Cashback, basta preecher os campos solicitados: 1 - Ative a funcionalidade; 2- Coloque o percentual de Cashback que você deseja conceder aos seus clientes em cada compra que realizarem; 3- Defina o valor da compra para que o cashback seja gerado (o valor mínimo de uma Cobrança com Cashback é de R$50,00). 4- Após preenchidos ambos os campos, clique em " Ativar." || Para saber mais sobre o Cashback e como ele poderá te ajudar a maximizar suas vendasclique no link: Cashback Habilitar Cashback Fidelidade Para habilitar o Cashback Fidelidade, basta preecher os campos solicitados: 1 - Ative a funcionalidade; 2- Coloque o percentual de Cashback Fidelidade que você deseja conceder aos seus clientes em cada compra que realizarem; 3- Defina o valor da compra para que o cashback seja gerado (o valor mínimo de uma Cobrança com Cashback é de R$50,00). 4- Após preenchidos ambos os campos, clique em " Ativar." || Para conhecer mais sobre o Cashback Fidelidade e como ele poderá te ajudar a maximizar suas vendas basta clicar no link: Cashback Fidelidade Pronto! Agora todas as cobranças criadas em seu e-commerce serão geradas com Cashback. Você também tem opção de criar uma cobrança com Cashback, através da plataforma. || Para mais informações sobre como criar uma cobrança com Cashback, clique no link: Como criar uma cobrança Ah! Você poderá acompanhar e gerenciar cada Cahsback gerado e resgatado, para tanto basta clicar em "Cashback" dentro do seu painel OpenPix.

Última atualização em Jan 08, 2026

Gerenciando permissões

Permissões possibilitam o gerenciamento de usuários em relação as atividades dentro da OpenPix. Como usuário administrador da plataforma, você poderá criar contas de acesso para outros usuários como, por exemplo, funcionários da sua empresa e, também, poderá selecionar a quais funcionalidades esses usuários terão acesso. Para gerenciar as permissões dos seus usuários, siga as orientações abaixo: Com a plataforma aberta, clique em "Permissões" Ao clicar em permissões a tela de usuários abrirá. Escolha o usuário a quem deseja setar as permissões e clique nele. Ao clicar no usuário, a tela contendo as informações do mesmo abrirá. Nesse ponto, clique em "permissões" Uma tela com todas as permissões disponíveis abrirá. Para selecionar a quais funcionalidades seu usuário terá acesso na plataforma, leia a descrição de cada uma e depois vá clicando em "Ativo" Após selecionar todas as permissões que deseja, as mesmas já ficarão ativas na conta do usuário. Criando um Grupo de Permissões Além das permissões que podem ser concedidas individualmente para cada usuário, você também pode criar um grupo de permissões. Ao criá-lo você conseguirá agrupar todas as permissões que deseja conferir a um determinado grupo de usuários, e concedê-las a estes, de uma única vez. E, depois, poderá ir adicionando, sempre que necessário, novos usuários ao grupo. Para criar um grupo de permissões clique em "Usuários/Permissões" A tela de Usuários, abrirá. Nesse ponto, clique em "Grupo de Permissões" Após, clique em "Cadastrar Grupo" Dê um nome ao grupo de permissões que deseja criar e faça uma breve descrição do mesmo e clique em "criar." Caso não queira fazer uma descrição do grupo, não é necessário. Apenas o nome é requisito obrigatório. Após criar o grupo, você será direcionado para a seguinte tela: Com o grupo criado, agora é necessário adicionar os usuários e definir as permissões que serão concedidas a estes. Adicionando usuário e Permissões Para adicionar um usuário ao seu grupo de permissões, clique em "Usuários" Após, clique em "+ Adicionar" Escolha os usuários que deseja adicionar ao grupo criado. || Para informações sobre como cadastrar um novo usuário na plataforma, clique no link: Criando um usuário Após adicionar os usuários ao grupo, clique em "Permissões" A tela com uma lista de permissões que a plataforma possui, abrirá. Selecione as opções que deseja atribuir a este grupo. Após selecionar as permissões, o grupo estará criado e os usuários, alocados dentro dele, terão acesso apenas ao que fora configurado. Caso, posteriormente, você deseje adicionar mais usuários ao grupo criado, basta clicar em "Usuários/Permissões" Após, clique em "Grupos de permissões" Localize o grupo criado e clique nele Depois, basta clicar em "+Adiconar" e incluir ao grupo os novos usuários

Última atualização em Jan 08, 2026

Prompt para integrar com a woovi usando IA (Lovable)

Este prompt foi criado para ser utilizado em ferramentas de geração de código por IA, como o Lovable, com o objetivo de integrar pagamentos via PIX utilizando a Woovi de forma simples e funcional. A ideia é fornecer instruções claras e diretas para que a IA gere automaticamente um checkout transparente ou utilizando o checkout hospedado da Woovi, evitando ambiguidades e reduzindo erros na implementação. Quando usar este prompt Utilize este prompt quando precisar: - Criar um checkout PIX integrado rapidamente - Gerar código backend e frontend automaticamente - Evitar implementação manual da lógica de pagamento - Padronizar integrações com a API da Woovi O que o prompt cobre O prompt orienta a IA a implementar: - Criação de cobrança via API da Woovi - Consulta de status da cobrança (/api/v1/charge/{id}) - Exibição de QR Code e código PIX (no checkout transparente) - Verificação automática do pagamento via polling (a cada 10 segundos) - Atualização dinâmica da interface sem recarregar a página - Boas práticas de segurança (API Key apenas no backend) Como utilizar 1. Copie o prompt fornecido na documentação 2. Cole diretamente na ferramenta de IA (ex: Lovable) 3. Aguarde a geração do código 4. Revise e ajuste conforme necessário ao seu ambiente Prompt: Crie uma integração de pagamento usando o checkout da Woovi (payment link) com PIX. API Woovi: Base URL: https://api.woovi.com Endpoint: - POST /api/v1/charge → criar cobrança - GET /api/v1/charge/{id} → consultar status Autenticação: Authorization: SUA_API_KEY Backend: Criar endpoint /charge: - Faz POST para /api/v1/charge - Retorna: - id - paymentLinkUrl Criar endpoint /check-status/:id: - Faz GET em /api/v1/charge/{id} - Retorna: - status - paidAt Frontend: - Criar botão "Pagar" Ao clicar no botão: - Chamar endpoint /charge - Redirecionar o usuário para: paymentLinkUrl OU (opcional, melhor UX): - Abrir paymentLinkUrl em uma nova aba ou iframe/modal Verificação de pagamento (opcional): - A cada 10 segundos, consultar /check-status/:id const interval = setInterval(async () => { const res = await fetch(`/check-status/${id}`); const data = await res.json(); if (data.status === 'COMPLETED') { clearInterval(interval); alert('Pagamento confirmado'); } if (data.status === 'EXPIRED') { clearInterval(interval); alert('Pagamento expirado'); } }, 10000); Regras: - ACTIVE → aguardando pagamento - COMPLETED → pagamento confirmado - EXPIRED → expirado Segurança: - Não expor API Key no frontend - Backend deve fazer todas chamadas para a Woovi Entrega esperada: - Código completo (backend + frontend) - Botão de pagamento funcional - Redirecionamento para checkout Woovi - Instruções para rodar o projeto

Última atualização em Apr 27, 2026

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: Tela "Lista de contas" com o botão "Nova conta Baas" destacado em vermelho 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 Modal "Criar uma nova conta virtual" com campo de CNPJ vazio e botões Cancelar / Continuar 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 Modal "Como você deseja iniciar o KYC?" com duas opções: KYC na plataforma (botão preenchido) e Gerar link de integração (botão contornado) 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: Tela de embed do KYC dentro do painel da Woovi: sidebar à esquerda, KYC iframe no centro mostrando o passo "Dados da Empresa" 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: Modal "Link de integração gerado" mostrando a URL gerada, botão Copiar link e botão Concluído 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].

Última atualização em May 13, 2026