# Conectar a Woovi

Fonte: https://docs.barbeiro.app/business-admin/settings/payments-connect-woovi
Perfil: Administrador
Verificado em: 2026-10-13

> A **Woovi** recebe os pagamentos dos seus clientes **só por Pix**, direto na sua conta Woovi. Para conectar, você copia o **AppID** no painel da Woovi, em um computador, e cola em **Configurações → Pagamentos**. Com a Woovi ativa, o cartão online deixa de aparecer para o cliente.

> **A Woovi está sendo liberada aos poucos**
>
> Se a linha da **Woovi** não aparece em **Configurações → Pagamentos**, ela ainda não está
> disponível para o seu negócio. Nesse caso, use um dos provedores da tela, como mostra o artigo
> sobre conectar o Mercado Pago, o Asaas ou o Stripe.

## Antes de começar

-   Você precisa de uma conta na **Woovi** com acesso de administrador.
-   O negócio precisa cobrar em **real**. A Woovi não aparece para negócios que cobram em outra moeda.
-   Faça a etapa da chave **em um computador**: o aplicativo da Woovi não mostra o AppID.

> **Só Pix, sem cartão online**
>
> A Woovi recebe apenas por **Pix**. Quando ela é o seu provedor ativo, seus clientes não
> conseguem mais pagar com cartão pelo site: o Pix passa a ser a única forma de pagamento online.
> O formulário de conexão mostra esse mesmo aviso antes de você colar o AppID. Pagamento no balcão
> continua normal.

## Passo a passo

1. Em **Configurações → Pagamentos**, na linha da **Woovi**, toque em **Conectar**. Um formulário
   abre logo abaixo da linha.

2. No computador, acesse o painel da Woovi e vá em **API/Plugins**. Crie uma chave nova e dê a ela
   o nome da plataforma, assim você sabe qual revogar depois.

3. Copie o **AppID** da chave que você acabou de criar. Copie o código inteiro, sem espaços no
   começo ou no fim.

4. Volte ao aplicativo, cole o AppID no campo **Chave de API** e toque em **Validar e salvar**. Se
   o AppID for aceito, a linha da Woovi mostra a etiqueta **Recebendo**. Se for o seu primeiro
   provedor, o pagamento online já é ativado automaticamente.

## O que acontece em seguida

-   **Agendamentos, pedidos da loja e planos** pagos por Pix geram um QR Code da sua conta Woovi. O
    dinheiro cai direto lá; a plataforma não guarda nem repassa nada.
-   Quando o cliente paga, o agendamento, o pedido ou a assinatura aparece como **pago** sozinho, em
    poucos segundos. Se o aviso da Woovi atrasar, o sistema confere de novo mais tarde e marca o
    pagamento mesmo assim.
-   **Planos mensais e anuais** podem ser cobrados por **Pix Automático**: o cliente paga o primeiro
    ciclo pelo QR Code, autoriza no banco dele e as renovações seguintes são debitadas sozinhas.
    Isso só aparece para o cliente quando **Permitir Pix Automático** está ligado nas formas de
    pagamento dos planos.

## Atenção aos detalhes

> **CPF ou CNPJ de quem paga**
>
> Para gerar o Pix, a Woovi pede o **CPF ou o CNPJ** de quem paga. Sem esse dado no cadastro do
> cliente, o QR Code não é gerado.

> **AppID de teste não recebe de verdade**
>
> Um AppID criado no ambiente de teste da Woovi é recusado aqui, com a mensagem de que a Woovi
> rejeitou a chave. Use o AppID da sua conta de verdade.

> **Planos com Pix Automático**
>
> O Pix Automático da Woovi funciona só para planos **mensais** e **anuais**. Para um plano com
> outro ciclo, como o semanal, deixe só o Pix comum ou o pagamento no local. Se você mudar o preço
> de um plano, a renovação que a Woovi já preparou para os próximos dias ainda sai com o valor
> antigo.

> **Seus dados estão seguros**
>
> Guardamos o AppID **criptografado** e o usamos só para receber os pagamentos dos seus clientes
> na **sua própria conta Woovi**. Você pode apagar a chave a qualquer momento no painel da Woovi,
> em **API/Plugins**, e a conexão para na hora.

## Perguntas frequentes

**Posso usar a Woovi para o Pix e outro provedor para o cartão?**
Não. O negócio recebe online por um provedor de cada vez. Se você precisa de cartão online, conecte o Mercado Pago, o Asaas ou o Stripe e deixe um deles como ativo.

**A chave parou de funcionar. O que faço?**
Se você apagar ou trocar a chave no painel da Woovi, a linha fica em **Erro**. Abra o menu **···** da linha e toque em **Verificar conexão** para testar a chave salva. Para voltar a receber, toque em **Trocar conta** e cole um AppID novo.

**Posso usar a mesma conta Woovi em dois negócios?**
Não. Cada conta Woovi recebe por um negócio só. Se o AppID colado já estiver conectado a outro negócio, a tela avisa e não conecta: crie uma conta Woovi para cada negócio.

**Posso trocar para outra conta Woovi?**
Pode, em **Trocar conta**, desde que não haja pagamento Pix em aberto na conta atual. Se houver, a tela avisa e mantém a conta de agora: espere esses pagamentos serem pagos ou expirarem e tente de novo.

**Como desconecto a Woovi?**
Em **Configurações → Pagamentos**, abra o menu **···** na linha da Woovi e toque em **Desconectar**. Se ainda houver pagamento em andamento ou assinatura com cobrança automática na Woovi, a tela não deixa desconectar até isso ser resolvido.

## Artigos relacionados

-   [Conectar o Mercado Pago, o Asaas ou o Stripe](./payments-connect-provider.md)
-   [Pagamentos](./payments.md)
-   [Mostrar ou esconder os planos de assinatura no site](./membership-visibility.md)

## Leia também

- [Conectar o Mercado Pago, o Asaas ou o Stripe](https://docs.barbeiro.app/business-admin/settings/payments-connect-provider)
- [Como receber pagamentos online](https://docs.barbeiro.app/business-admin/settings/payments)
- [Mostrar ou esconder os planos de assinatura no site](https://docs.barbeiro.app/business-admin/settings/membership-visibility)