Primeiros passos

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, abra Integrações no menu lateral. Em Gateways de pagamento, clique em Instalar (ou Configurar, se já estiver instalado) no cartão do Asaas. A configuração abre numa janela.

Cole a chave da API copiada do painel Asaas no campo Chave de API do Asaas e clique em Salvar. A chave é guardada criptografada e nunca é exibida de volta — depois de salva, o campo mostra que já existe uma chave cadastrada; digite só se quiser substituí-la.

Ao salvar, o Baila faz uma chamada de teste na API do Asaas para confirmar que a chave funciona (você também pode repetir com Validar credenciais). Se falhar, revise o status da sua conta Asaas (CPF/CNPJ verificado, conta ativa e sem pendências) antes de tentar de novo. Enquanto a chave não estiver validada, você não consegue publicar eventos pagos.

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 Integrações › Asaas, seção Webhook, clique em Gerar token e depois em Copiar (formato baila_whk_...). Se você já tinha gerado um token antes, ele continua o mesmo — não é preciso mudar nada no Asaas. 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_RECEIVED
  • PAYMENT_CONFIRMED
  • PAYMENT_OVERDUE
  • PAYMENT_DELETED
  • PAYMENT_REPROVED_BY_RISK_ANALYSIS
  • PAYMENT_REFUND_IN_PROGRESS
  • PAYMENT_REFUNDED
  • PAYMENT_CHARGEBACK_REQUESTED
  • PAYMENT_AWAITING_CHARGEBACK_REVERSAL
  • PAYMENT_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. Você não vai conseguir publicar novos eventos pagos até cadastrar a chave de novo e validá-la em Integrações › Asaas.

Conferir o que falta: a página Pagamentos

A página Pagamentos (menu lateral) mostra, passo a passo, o que já está pronto no seu gateway — chave salva, chave validada, webhook, carteira de recebimento — e o que cada passo libera: vender ingressos e publicar eventos pagos, cobrar o fã-clube, fazer co-hosting com divisão de receita. Cada passo pendente tem um botão que abre a janela do Asaas direto no ponto certo.

Artigos relacionados

Como funcionam os plugins em Integrações

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 18/09/2026

Como configurar meu perfil: CPF, CNPJ e dados pessoais

Adicione seu CPF ou CNPJ e dados de contato no painel para liberar a publicação de eventos pagos, e monte a sua página pública em blocos.

O que é o modelo BYOG e como ele funciona no Baila

Entenda por que o dinheiro dos ingressos cai direto na sua conta Asaas — sem passar pelo Baila.

On this page

Antes de começarPasso a passoConfigurar o webhook no AsaasDados do WebhookEventos a marcarO que acontece se a chave expirarConferir o que falta: a página PagamentosArtigos relacionados