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.

Atualizado em 09/11/2026 Recurso do plano: Pagamento automático via PixSó o dono da marca

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#

Card Asaas com o campo Chave de API do Asaas
  1. Vá em Configurações › Pagamentos.
  2. Em Pix automático das comissões, clique em Conectar Asaas.
  3. No painel do Asaas, abra Integrações → Chave de API, gere uma chave e copie.
  4. 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.

  1. No card do Asaas, veja o bloco Falta 1 passo no Asaas, com dois campos: URL e Token de autenticação.
  2. No Asaas, abra Menu do usuário → Integrações → Mecanismos de segurança.
  3. Ative a validação de saque via webhook.
  4. Cole a URL e o Token de autenticação que o painel mostra (use o botão de copiar ao lado de cada um).
  5. Salve no Asaas.
  6. 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#

  1. 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#

MensagemPor 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

Este artigo ajudou?

Não resolveu?

Fale com a gente. A mensagem já vai com a tela e o artigo, para agilizar o atendimento.

Leia também