Como conectar meu gateway de pagamento Asaas
Conecte sua conta Asaas ao Baila (modelo BYOG) para receber pagamentos diretamente, sem intermediação.
O Baila usa o modelo BYOG (Bring Your Own Gateway): o dinheiro dos ingressos cai direto na sua conta Asaas, sem passar pelo Baila. Para isso funcionar, você precisa conectar sua conta Asaas ao painel uma única vez.
Antes de começar
Você vai precisar de:
- Uma conta Asaas ativa com CPF/CNPJ verificado
- A chave da API Asaas (production ou sandbox) — obtida em asaas.com → Perfil (canto direito superior) → Integrações → Chaves da API
- Seu perfil no Baila já preenchido com CPF/CNPJ (veja o artigo relacionado)
Passo a passo
No painel Baila, acesse Perfil → aba Pagamentos.
Cole a chave da API copiada do painel Asaas. E clique em Salvar Configuração.
O Baila faz uma chamada de teste na API do Asaas para confirmar que a chave é válida antes de salvar. Se a validação falhar, revise o status da sua conta Asaas (CPF/CNPJ verificado, conta ativa e sem pendências) antes de tentar de novo.
Em seguida, configure o webhook no painel Asaas seguindo a seção abaixo. Sem isso, confirmações de pagamento, reembolsos e chargebacks não chegam no Baila.
Nunca compartilhe sua chave da API Asaas. Ela dá acesso total à sua conta de recebimento. Se suspeitar de vazamento, revogue a chave no painel Asaas imediatamente e gere uma nova.
Configurar o webhook no Asaas
No painel Asaas, acesse Integrações → Webhooks → Adicionar Webhook e preencha exatamente os campos abaixo. Sem essa etapa, o Baila não recebe confirmações de pagamento, reembolsos nem chargebacks.
Dados do Webhook
-
Este Webhook ficará ativo? — ative o toggle.
-
Nome do Webhook — qualquer nome identificável (ex.:
Baila). -
URL do Webhook — cole exatamente:
https://api.vaidebaila.app/api/webhooks/asaas -
E-mail — um email que você acessa: o Asaas avisa por aí se a entrega do webhook falhar.
-
Versão da API — selecione v3.
-
Token de autenticação — cole o token do webhook gerado pelo Baila. No painel Baila, em Perfil → aba Pagamentos, na seção Configuração de Webhook, clique em Gerar token — o valor (formato
baila_whk_...) é copiado automaticamente para a sua área de transferência. Esse token é como o Baila confirma que o webhook veio mesmo da sua conta Asaas. -
Tipo de envio — selecione Sequencial (recomendado para preservar a ordem dos eventos).
-
Fila de sincronização ativada? — deixe ativada.
Eventos a marcar
Em Adicionar Eventos → Cobranças, marque os eventos abaixo.
Atalho: você pode clicar em Selecionar Todos na seção Cobranças — os eventos extras são ignorados pelo Baila sem efeito colateral.
Se preferir marcar só o necessário, ative apenas estes (o Baila ignora os demais):
PAYMENT_RECEIVEDPAYMENT_CONFIRMEDPAYMENT_OVERDUEPAYMENT_DELETEDPAYMENT_REPROVED_BY_RISK_ANALYSISPAYMENT_REFUND_IN_PROGRESSPAYMENT_REFUNDEDPAYMENT_CHARGEBACK_REQUESTEDPAYMENT_AWAITING_CHARGEBACK_REVERSALPAYMENT_CHARGEBACK_DISPUTE
Clique em Salvar no canto superior direito para concluir.
O que acontece se a chave expirar
Se o Asaas revogar ou invalidar sua chave, o Baila não consegue mais capturar pagamentos. O dashboard exibe um banner vermelho alertando e bloqueia a publicação de novos eventos pagos até você reconectar.
Artigos relacionados
O que é o modelo BYOG e como ele funciona no Baila
Como configurar meu perfil: CPF, CNPJ e dados pessoais
O que é a taxa de 3% do Baila e quando ela é cobrada
Atualizado em 22/04/2026