Um retreat de 2.000 USD é um pedido pesado de cara. As parcelas deixam quem reserva se comprometer com uma cobrança inicial menor e pagar o resto num calendário atrelado à data de início do retreat. A plataforma cuida das cobranças off-session automaticamente.
Só plano Premium. Só reservas com cartão via Stripe (métodos off-platform não dá para cobrar off-session).
Como funciona
Você define um template uma vez ao criar o retreat. Cada pessoa que opta por parcelar ganha o próprio ledger de parcelas resolvido a partir desse template.
O template é uma lista de etapas. Cada etapa tem:
offsetDays: quando cobrar, relativo à data de início do retreat. Negativo significa antes (por exemplo -30 = trinta dias antes do início). 0 = no momento da inscrição.percentageBps: o percentual em pontos-base (5000 = 50%, 3333 = 33,33%).
Os percentuais devem somar exatamente 10000 (= 100%). O offset da primeira etapa precisa ser <= 0 para que quem reserva pague no checkout.
Três formas comuns
Duas etapas, 50/50:
- Etapa 1: offsetDays 0, 50%
- Etapa 2: offsetDays -30, 50%
Três etapas, 50/25/25:
- Etapa 1: offsetDays 0, 50%
- Etapa 2: offsetDays -60, 25%
- Etapa 3: offsetDays -14, 25%
Quatro etapas, quartos iguais:
- 25% na inscrição, 25% em -90, 25% em -60, 25% em -14.
O que acontece no checkout
Quem reserva escolhe "Pagar parcelado" na página de reserva. Cobramos a parcela nº 1 na hora via Stripe e salvamos o cartão para as etapas futuras (setup_future_usage: off_session da Stripe).
O que acontece depois
Um cron diário às 07:00 UTC percorre cada parcela SCHEDULED cujo scheduledFor já passou. Cada uma é cobrada no cartão salvo. Em sucesso: marcada como PAID, e-mail de recibo enviado. Em falha: retry após uma graça de 3 dias (default), até 2 vezes a mais. Esgotado o limite de retry: a parcela vira FAILED, a reserva é cancelada, as parcelas SCHEDULED restantes viram CANCELLED, e quem reservou recebe um e-mail.
Parcelas anteriores NÃO são reembolsadas em falha final. É o contrato publicado; quem reservou perde o valor.
O que quem reserva vê
Na página de confirmação da reserva: cada linha de parcela com a data programada, valor e status (Paid / Scheduled / Failed / Cancelled). O agent também pode listá-las via o tool MCP list_my_installments.
Reembolsos para reservas parceladas
Quando você cancela e reembolsa a reserva, a base elegível é a SOMA das parcelas já PAID (não o total contratado; não dá para reembolsar dinheiro que não foi cobrado). As linhas SCHEDULED restantes são canceladas na mesma transação para o cron parar de tentar. Veja Aceitar pagamentos para o flow completo de reembolso.