Pix automático com Asaas
Conecte sua conta Asaas, configure a validação de saque via webhook e ligue o pagamento automático. O Pix sai sozinho quando você aprova um saque.
Com o Asaas conectado, o Pix para a afiliada sai da sua conta Asaas quando você aprova o pagamento. Você não precisa copiar chave nem fazer transferência no banco.
Só o dono da marca conecta e configura. A marca usa uma conta por vez: Asaas ou Woovi.
Antes de começar#
- Tenha acesso de administrador à conta Asaas da marca.
- Tenha saldo no Asaas: os Pix e a tarifa saem de lá. A tela de escolha mostra a tarifa como "30 Pix grátis por mês, depois R$ 2,00". "As tarifas acima são da Asaas e da Woovi, cobradas direto na conta que você conectar. O Hub não cobra nada por Pix enviado."
Passo 1: conectar a chave de API#
- Vá em Configurações › Pagamentos.
- Em Pix automático das comissões, clique em Conectar Asaas.
- No painel do Asaas, abra Integrações → Chave de API, gere uma chave e copie.
- Cole em Chave de API do Asaas e clique em Conectar.
Aparece "Asaas conectado." e o card mostra o saldo ("R$ … disponíveis"). A chave fica criptografada e não é exibida de novo.
Passo 2: a autorização de saques ("Falta 1 passo no Asaas")#
Sem este passo, o painel não envia Pix pelo Asaas.
- No card do Asaas, veja o bloco Falta 1 passo no Asaas, com dois campos: URL e Token de autenticação.
- No Asaas, abra Menu do usuário → Integrações → Mecanismos de segurança.
- Ative a validação de saque via webhook.
- Cole a URL e o Token de autenticação que o painel mostra (use o botão de copiar ao lado de cada um).
- Salve no Asaas.
- Volte ao painel e clique em Já configurei.
Aparece "Autorização de saques ativa no Asaas."
Com a validação ligada, o Asaas pergunta ao Hub antes de liberar cada saque feito pela API da sua conta. Saques que não foram criados aqui (por outra integração, por exemplo) serão recusados.
Passo 3: ligar o pagamento automático#
- Ligue a chave Pagar automaticamente ao aprovar: "Ao aprovar um saque, o Pix é enviado na hora para a chave cadastrada por quem solicitou."
A chave só liga depois do passo 2. Com ela ligada, o botão Aprovar em Pagamentos vira Aprovar e pagar via Pix. Com ela desligada, você aprova primeiro e depois clica em Pagar via Pix em cada pagamento (ou em lote).
Como fica em Pagamentos#
- No topo da lista aparece Asaas, o "saldo para saques" e "Pix automático ao aprovar" (ou "Pix automático desligado"), com o link Configurar.
- Pix enviado: o pagamento fica Pix em andamento até o Asaas confirmar e depois Pago, "via Pix automático".
- Em lote, os Pix saem do mais antigo para o mais novo, até acabar o saldo. Os que ficarem sem saldo mostram "Saldo insuficiente na conta Asaas. Adicione saldo e use "Pagar via Pix" para tentar de novo."
- Se algo falhar, veja o Pix falhou.
Trocar a chave ou desconectar#
- Trocar chave: cole a nova chave e clique em Trocar chave. Toda reconexão desliga o pagamento automático e pede o passo 2 de novo.
- Desconectar Asaas e Confirmar desconexão. Desative também a validação de saque via webhook no Asaas: se ela continuar ligada, os saques feitos pela API da sua conta serão recusados.
Erros comuns e o que fazer#
| Mensagem | Por quê | O que fazer |
|---|---|---|
| "Cole a chave de API completa do Asaas." | A chave está incompleta. | Copie a chave inteira. |
| "O Asaas recusou essa chave. Confira se copiou inteira e se ela está ativa." | Chave errada ou desativada. | Gere outra chave no Asaas. |
| "Não foi possível falar com o Asaas agora. Tente novamente em instantes." | O Asaas não respondeu. | Tente de novo em alguns minutos. |
| "A Woovi está conectada. Desconecte a Woovi antes de conectar o Asaas." | Só uma conta por vez. | Desconecte a Woovi primeiro. |
| "Confirme primeiro a autorização de saques no Asaas." | Tentou ligar o pagamento automático antes do passo 2. | Faça o passo 2 e clique em Já configurei. |
| "Há pagamentos Pix em andamento. Aguarde até que terminem para desconectar." | Há Pix sendo processado. | Espere terminar. |
| "Conectado, mas não conseguimos registrar o aviso automático de status no Asaas (…)." | O aviso de status não foi registrado. | Não precisa fazer nada: os pagamentos são conferidos a cada 10 minutos. Para tentar registrar de novo, troque a chave. |
| "A chave de API do Asaas foi recusada. Reconecte com uma chave válida." | A chave foi revogada no Asaas. | Gere uma nova chave e use Trocar chave. |
No painel: /app/configuracoes/pagamentos

