A capacidade central da série está no ar: você pode agendar uma cobrança PIX ou Boleto para um cliente cadastrado, e a Garu cuida do resto — e-mail no dia, lembretes para o time se atrasar, e ações de ciclo de vida para ajustar o caminho.

O que mudou

Dashboard

• Nova página /cobrancas-agendadas no menu lateral, com 5 abas (Próximas / Vencidas / Pausadas / Trial / Concluídas), busca por cliente e wizard "Nova cobrança" em 4 passos (Cliente → Produto → Detalhes → Revisar).
• Página de detalhes com timeline da cobrança, transações geradas e botões de ação contextuais (Adiar / Pausar / Retomar / Marcar como paga) gated pelo state-machine.
• Sub-aba "Cobranças agendadas" na página do cliente.
• Filtro "Em atraso" na lista de clientes.
• Toggle de notificação scheduled_charge_overdue em Configurações → Notificações para silenciar os lembretes do time.

API

Sete endpoints novos sob /api/scheduled-charges:

• POST /api/scheduled-charges — agendar (apenas type: "one_time" nesta versão).
• GET /api/scheduled-charges — listar (filtros: status simples ou array, customerId, type, dueFrom/dueTo, search).
• GET /api/scheduled-charges/:id — detalhes em pacote { charge, events, transactions }.
• POST /api/scheduled-charges/:id/postpone — adiar.
• POST /api/scheduled-charges/:id/pause — pausar.
• POST /api/scheduled-charges/:id/resume — retomar.
• POST /api/scheduled-charges/:id/mark-paid — registrar pagamento off-Garu.

Cobranças agendadas usam BRL decimal (ex: 297.50), diferente das transações Garu que usam centavos. Veja a documentação completa.

Webhooks

Novos eventos: scheduled_charge.created, scheduled_charge.postponed, scheduled_charge.paused, scheduled_charge.resumed, scheduled_charge.charged, scheduled_charge.overdue (D+1 / D+2 / D+3), scheduled_charge.paid, scheduled_charge.failed.

SDK Node + MCP

• @garuhq/node 0.5.0 — novo recurso garu.scheduledCharges.* com 7 métodos. customers.list({ status: "overdue" }) para listar clientes com cobrança em atraso.
• @garuhq/mcp 0.5.0 — 7 novas tools (create_scheduled_charge, list_scheduled_charges, get_scheduled_charge, postpone_scheduled_charge, pause_scheduled_charge, resume_scheduled_charge, mark_paid_scheduled_charge).

Quem vê o quê

Permissões novas:

• scheduled_charge:view — listar e ver cobranças.
• scheduled_charge:create — agendar.
• scheduled_charge:edit — adiar, pausar, retomar, marcar como paga.
• scheduled_charge:delete — cancelar.

Por padrão: Owner e Administrator têm tudo; Support tem ver/editar/cancelar; Developer, Analyst e View Only têm apenas ver.

Próximos passos

• Cobranças recorrentes (mensal, anual, com período de trial).
• Cartão de crédito como método agendável (após tokenização do cliente).
• Portal do cliente em /minha-area para o próprio cliente acompanhar e pagar cobranças sem login.