Garu

2026-10-02

v0.29.0 — Cobrança agendada recorrente: seu cliente paga com cartão pelo link

scheduled-chargescartaocobrancasminha-area

Seu cliente pode pagar a cobrança agendada recorrente com cartão. Até agora, o link do e-mail de vencimento só abria o Pix Automático, e uma recorrência só com cartão não tinha onde receber o cartão.

Como funciona para o cliente

  • O e-mail do dia do vencimento leva a uma página da Garu com o nome da sua loja, o valor do ciclo, a descrição e o vencimento.
  • Ele digita o cartão e toca em Pagar. O pagamento é à vista, em 1x, no valor do ciclo. O valor vem da cobrança: a página não deixa escolher outro.
  • A página mostra Processando pagamento enquanto o banco confirma, e Pagamento aprovado quando confirma.
  • Se o banco recusar, a página diz o motivo em português (saldo ou limite, cartão vencido ou bloqueado, CVV, segurança) e pede para conferir os dados ou usar outro cartão. Nenhum código do banco aparece para o cliente.
  • Um ciclo em atraso também pode ser pago com cartão. É para essa página que os e-mails de atraso e de cartão recusado levam o cliente.
  • O cartão fica salvo com segurança no processador. As próximas cobranças da assinatura vão nele sozinhas, sem novo e-mail para pagar. A página avisa isso antes do pagamento.
  • Se você ofereceu cartão e Pix Automático, o cliente escolhe. Só Pix Automático continua igual a antes.
  • Em /minha-area, a assinatura com um ciclo vencendo hoje ou em atraso ganha o botão Pagar agora, que abre a página daquele ciclo.

O que acontece do seu lado

  • O ciclo vira Pago e dispara o webhook scheduled_charge.paid, como no Pix Automático.
  • O cartão salvo dispara scheduled_charge.payment_method_attached.
  • Se a cobrança automática de um ciclo seguinte for recusada, o ciclo entra nas retentativas automáticas e, se elas não passarem, o cliente recebe o e-mail com o link para pagar.

Por enquanto

  • PIX e boleto avulsos por ciclo ainda não têm página. Se a recorrência só oferece PIX ou boleto, a página pede ao cliente para falar com você.
  • O Pix Automático continua aceitando só ciclos que ainda não venceram.