Por que isso existe

Até agora, a única forma de uma assinatura recorrente cobrar sozinha a cada ciclo era cartão de crédito: o cliente tokeniza uma vez e os ciclos seguintes são debitados em silêncio. Pix recorrente, por outro lado, mandava um link novo a cada ciclo — o cliente tinha que pagar de novo toda vez. O Pix Automático (o débito recorrente do Banco Central) fecha essa lacuna: o cliente autoriza uma vez no app do banco e, a partir daí, os ciclos são debitados automaticamente.

Como funciona

• Ao criar uma cobrança recorrente com um produto vinculado, agora aparece o método Pix Automático (ao lado de PIX, Boleto e Cartão).
• No ciclo 1, o cliente abre uma página de autorização, escaneia o QR Code no app do banco e confirma o consentimento do Pix Automático — uma única vez.
• Nos ciclos seguintes, o débito acontece sozinho na data de vencimento, sem nenhuma ação do cliente — exatamente como no cartão.
• Falhas (saldo insuficiente, autorização revogada) entram no mesmo fluxo de retentativa e dunning já usado pelo cartão.

Primeiro segundo processador

Esta é a primeira integração da Garu com um segundo processador de pagamento — o Woovi — ao lado do Celcoin. O Pix Automático tem namespace, webhook e mapeamento de erros próprios, sem tocar no fluxo existente do Celcoin. Na prática, é o primeiro passo para uma arquitetura com redundância entre provedores.

Para desenvolvedores

• POST /api/scheduled-charges agora aceita "pix_automatic" no array methods (válido apenas em cobranças recurring com productId).
• Novos endpoints públicos da página hospedada: POST /public/pay/scheduled/:seriesId/cycles/:n/pix-automatic (gera o QR de consentimento) e GET /public/pay/scheduled/:seriesId/cycles/:n/status (polling do status do ciclo).
• Webhook de entrada do Woovi em POST /api/webhooks/woovi, com verificação própria de autenticidade.
• Wrappers de SDK e ferramenta MCP para o novo método chegam em seguida nos repositórios públicos.