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.