Cobrar por um agendamento com Stripe no Cal: guia passo a passo
Se você vende consultoria, aulas ou sessões de mentoria, já conhece a cena: alguém marca uma hora do seu tempo, não aparece e fica por isso mesmo. A solução mais comum é cobrar na hora de agendar. Um horário pago raramente é cancelado no mesmo dia.
O Calendly tem seu guia de pagamento no agendamento e uma página de pagamentos: você conecta Stripe ou PayPal, ativa a cobrança em cada tipo de evento e o dinheiro vai para a sua conta. Segundo a central de ajuda deles, a cobrança não está em todos os planos, então confira o seu antes de montar qualquer coisa.
Aqui vai a versão do Cal: como configurar, o que acontece nos casos incômodos e o que ainda não faz. Tudo o que segue vem do código, que é aberto.
Como a cobrança funciona no Cal
O Cal não cobra por você nem fica no meio do caminho. Você usa a sua conta Stripe e entrega ao Cal uma chave secreta. O Cal a guarda criptografada e a usa para criar uma sessão do Stripe Checkout por agendamento. O dinheiro vai do Stripe para a sua conta. As taxas do Stripe são as do seu contrato com ele.
A sequência, do lado do convidado:
- Escolhe um horário na sua página de agendamento e preenche o formulário.
- O Cal salva o agendamento como pendente e reserva o horário por 35 minutos. Nesse intervalo ninguém mais pode pegá-lo.
- O convidado paga no Stripe Checkout.
- O Stripe avisa o Cal por webhook e o agendamento vira confirmado. Só então saem o email de confirmação e o evento no calendário.
Se o convidado volta sem pagar ou a sessão expira, o horário é liberado sozinho.
Passo 1: conectar o Stripe
Vá em Cal → Configurações → Pagamentos com Stripe. São três dados:
- Chave secreta (começa com
sk_ourk_). Uma chave restrita (rk_) funciona e é a opção mais organizada: dê permissão só para Checkout Sessions e Refunds. O Cal mostra apenas os quatro últimos caracteres e se é modo teste ou live. - URL do webhook. O Cal dá uma única por workspace. Copie.
- Signing secret do webhook (
whsec_). Você o gera no Stripe, em Developers → Webhooks, colando essa URL.
No webhook do Stripe, marque estes quatro eventos: checkout.session.completed, checkout.session.expired, checkout.session.async_payment_succeeded e checkout.session.async_payment_failed.
O Cal exige as duas peças, chave e signing secret, para aceitar agendamentos pagos. Se faltar o secret, os convidados não conseguem agendar esse evento e o editor avisa. É de propósito: sem webhook, um pagamento que o convidado conclui sem voltar à sua página poderia ficar cobrado com o agendamento já vencido.
Só o owner ou um admin do workspace pode alterar essa configuração.
Passo 2: colocar preço em um tipo de evento
No editor do tipo de evento, aba Pagamentos, você escolhe preço e moeda. As moedas disponíveis são USD, EUR, ARS, BRL, MXN, CLP, COP e GBP. Com preço 0, o evento não é cobrado.
O Cal valida algumas regras ao salvar:
- O valor aceita
15000,15.000ou15.000,50. Um único separador seguido de três dígitos é lido como milhar. - CLP não tem centavos: informe um número inteiro.
- O Stripe impõe um mínimo por cobrança. O Cal o conhece para USD, EUR, GBP, BRL e MXN e rejeita um preço menor antes de o Checkout falhar em produção.
Teste primeiro com uma chave em modo teste e o cartão de teste do Stripe. Faça um agendamento completo, veja se a confirmação chega e cancele para ver o reembolso.
O que acontece nos casos incômodos
Um fluxo de pagamento se testa pelo que dá errado, não pelo caminho feliz. Isto é o que o Cal faz:
- O convidado não paga. Aos 35 minutos a reserva do horário vence, o horário volta a ficar livre e o agendamento pendente é descartado.
- Paga depois de a reserva vencer. Se o horário continua livre, o agendamento é confirmado mesmo assim. Se outra pessoa pegou, o pagamento é reembolsado por inteiro de forma automática.
- Meios de pagamento com atraso (voucher em dinheiro, boleto). A reserva se estende por até 72 horas, nunca depois do início da reunião. Se o pagamento cair com a reunião já iniciada, é reembolsado.
- Você cancela um agendamento pago. Seja o anfitrião, o convidado ou a API, o Cal reembolsa o pagamento completo e marca como "reembolsado". Se o Stripe falhar nesse momento, o agendamento fica cancelado com o pagamento ainda como pago, para você reembolsar manualmente pelo Stripe.
- Você apaga um tipo de evento com agendamentos futuros. O Cal pede que você os cancele antes, e ao cancelar os convidados são avisados e os pagamentos reembolsados.
- Eventos de outra origem. O Cal ignora webhooks que não trazem seus metadados ou cujo valor e moeda não batem com o agendamento. Um Payment Link na mesma conta Stripe não consegue confirmar nem cancelar agendamentos.
Uma política de cobrança que funciona
O Cal sempre reembolsa o valor total. Se você quer uma política mais fina, monte-a no desenho do evento:
- Uma primeira sessão curta e paga. Uma conversa de 20 ou 30 minutos a preço baixo filtra os curiosos sem afastar ninguém. A sessão longa é marcada depois.
- Aviso mínimo longo. Com 24 horas de aviso mínimo, quem agenda já sabe que não é para hoje. Veja buffers, aviso mínimo e janela de agendamento.
- Uma pergunta antes. Uma pergunta obrigatória no formulário ("o que você quer resolver na sessão?") permite chegar preparado.
- Um workflow de lembrete. Um email 24 horas antes com o link da reunião e o de reagendamento reduz reclamações. Mais em menos faltas em reuniões com o Cal.
O que ainda não faz
O Cal é direto sobre suas lacunas. Hoje:
- Só há Stripe. PayPal não existe.
- Não há cupons nem descontos, nem pagamentos parciais ou sinal.
- Reembolsos parciais são feitos pelo Stripe, não pelo Cal.
- Não calcula impostos: isso fica na configuração da sua conta Stripe.
Se algum desses pontos for indispensável para você, o Calendly ou um Payment Link próprio resolvem hoje.
Quanto custa
Self-host: $0, com a cobrança incluída, porque o core é AGPL com todas as funções. No zerosoft Cloud não há preço por usuário: paga-se por agendamento e armazenamento, e a taxa do Stripe é separada e vai direto para a sua conta Stripe. Para o raciocínio completo sobre por que um agendamento não deveria custar por assento, leia Cal vs Calendly.
Checklist final
- Chave restrita do Stripe em modo teste carregada no Cal.
- Webhook criado com os quatro eventos e o signing secret colado.
- Preço e moeda no tipo de evento, respeitando o mínimo.
- Um agendamento de teste completo, confirmado e cancelado com reembolso.
- Só então, chaves live e o preço real.