aJenda

Ajuda · Pagamentos

Pagamentos e Asaas

Este guia cobre a configuração do sinal de agendamento: conta Asaas, API key, webhook, regras da empresa e override por profissional. A assinatura mensal da aJenda usa a Asaas da plataforma — aqui falamos só do dinheiro que cai na sua conta (ou na de cada profissional).

Visão geral

No plano Completo (ou com o add-on de taxa de agendamento), o cliente pode pagar um sinal (Pix ou cartão) para confirmar o horário. O valor entra na conta Asaas que você configurar.

Há dois modos de recebimento no painel:

  • Conta da empresa — uma API key Asaas da empresa; todo sinal cai nela.
  • Conta de cada profissional — cada profissional tem a própria API key; o sinal do atendimento dele cai na conta dele.

1. Criar a conta na Asaas

  1. Acesse asaas.com e crie uma conta (PF ou PJ, conforme o seu negócio).
  2. Conclua a validação cadastral pedida pela Asaas (documentos). Sem isso, cobranças podem ficar limitadas.
  3. Confirme que consegue ver o menu Integrações / API no painel Asaas.

2. Gerar a API key

  1. No painel Asaas, abra Integrações → API Keys (ou “Chaves de API”).
  2. Crie uma chave de produção (não use sandbox na operação real).
  3. Copie a chave completa (costuma começar com $aact_). Guarde com cuidado — ela dá poder de emitir cobranças na sua conta.

Não compartilhe a API key em grupos ou prints públicos. No painel aJenda ela fica salva de forma segura e não é exibida de novo depois de salva.

3. Configurar o webhook

O webhook avisa a aJenda quando o Pix/cartão for pago. Sem ele, o agendamento pode ficar “aguardando pagamento” mesmo depois do cliente pagar.

  1. No Asaas: Integrações → Webhooks → Novo webhook (ou equivalente).
  2. URL: https://api.ajenda.com.br/webhooks/asaas
  3. Token de autenticação (asaas-access-token): use o token que a aJenda fornecer. Peça no WhatsApp se ainda não tiver.
  4. Eventos mínimos: PAYMENT_CONFIRMED, PAYMENT_RECEIVED, PAYMENT_OVERDUE, PAYMENT_DELETED (e REFUNDED se disponível).
  5. Salve e deixe o webhook ativo.

Token e dúvidas: WhatsApp (73) 99947-4687.

Se a URL acima mudar no seu ambiente (sandbox), o suporte confirma a URL correta.

4. Colar no painel aJenda

  1. Entre em admin.sandbox.ajenda.com.br → Configurações.
  2. Abra o card “Sinal e Asaas (agendamentos)”.
  3. Escolha “Conta da empresa” (modo mais simples) ou “Conta de cada profissional”.
  4. Com “Conta da empresa”: cole a API key Asaas e salve.
  5. Ative “Cobrar sinal no agendamento online” (precisa do add-on / plano com essa função).
  6. Defina tipo do sinal (valor fixo em R$ ou % do serviço), valor e meios (Pix / cartão).
Abrir Configurações

5. Cadastro por profissional

Se o modo for Conta de cada profissional:

  • Cada profissional precisa de conta Asaas própria + API key + o mesmo webhook (URL e token da aJenda).
  • Em Profissionais → editar, cole a API key no bloco de pagamentos.
  • Sem API key no profissional, o sinal daquele atendimento não consegue ser cobrado.

6. Sinal, force e override

Regra da empresa (padrão)

Em Configurações você define se cobra sinal, o tipo (fixo ou %), o valor e os meios aceitos. Isso vale para todos, salvo override.

Forçar regra da empresa (sem override)

Se ativo, profissionais não podem definir sinal próprio — sempre vale a regra da empresa.

Override do profissional

Se o force estiver desligado, no cadastro do profissional aparece “Usar regra própria de sinal”. Aí ele pode cobrar sinal diferente (ou desligar o sinal só para ele), sem mudar o padrão da empresa.

7. Cobrar 100% do serviço

O sinal pode ser o valor integral do serviço no momento do agendamento:

  1. Tipo do sinal: Percentual do serviço (%).
  2. Percentual: 100.
  3. Meios: Pix e/ou cartão, conforme preferir.
  4. Salve em Configurações (ou no override do profissional).

Com 100%, o cliente paga o serviço todo para confirmar o horário. Valores fixos em R$ também funcionam se você preferir um sinal menor (ex.: R$ 30) e o restante no atendimento.

Checklist “está funcionando?”

  • API key salva no painel (empresa ou profissionais).
  • Webhook ativo na Asaas com a URL e o token da aJenda.
  • Add-on / plano com taxa de agendamento liberado.
  • “Cobrar sinal” ligado e valor > 0.
  • Faça um agendamento de teste no site do negócio e pague o Pix (valor baixo). O status deve sair de aguardando pagamento após a confirmação.

Ainda com dúvida?

WhatsApp (73) 99947-4687 — pedimos URL/token do webhook ou revisamos sua configuração juntos.

Falar no WhatsAppVoltar à ajuda