2026-08-27

v0.21.0 — App: aba Produtos, com o link de afiliada no bolso

O link de afiliada só existia no painel web. Agora o app tem a aba Produtos, com dois modos: seus produtos (para copiar o link de pagamento) e suas afiliações (com o link que paga sua comissão, o saldo de comissões e os convites pendentes, que dá para aceitar por ali mesmo). Produto de assinatura pede qual plano o link vende, em vez de deixar o checkout escolher. Junto foi uma correção de paginação que fazia a lista de produtos devolver páginas incompletas.

2026-08-16

v0.20.1 — Aceitar convite de afiliado voltou a funcionar (e a página cabe no celular)

O botão "Aceitar convite" da página de afiliado devolvia erro para todo mundo — desde novembro, silenciosamente. A causa era um detalhe de compilação que desligava a validação daquela rota e descartava o corpo da requisição inteiro. Junto foram as correções de layout no celular (convite e cadastro), o link do app na App Store no rodapé, e respostas de erro que agora dizem a verdade.

2026-08-15

v0.20.0 — Carnê: venda parcelada no boleto, com o líquido na tela

Agora dá para vender um produto em até 12 boletos mensais. Cada parcela é emitida 7 dias antes do vencimento, o cliente vê o custo do parcelamento como manda o CDC, e o painel mostra quanto você recebeu de verdade — não quanto o cliente pagou. Junto vão quatro correções de dinheiro, incluindo comissão de afiliado que sumia em toda venda por link.

2026-07-28

v0.19.0 — Pix Automático virou configurável por produto (e o Descritor da Fatura saiu)

A chave Pix Automático do formulário de produto podia ser desligada, salvava com sucesso e voltava ligada ao recarregar — o campo nunca era gravado por rota nenhuma. Agora a chave funciona, e POST e PATCH /api/v1/products aceitam pixAutomatic de verdade. Na outra ponta, o campo Descritor da Fatura saiu do formulário: ele nunca chegou a lugar nenhum.

2026-07-28

v0.18.0 — Programa de afiliados voltou a salvar, e PATCH /products virou atualização parcial de verdade

Ativar afiliação em um produto falhava com 400 para todo mundo — a tela reenviava a tabela de parcelas onde a API espera um número. Junto veio a correção de escopo: PATCH e DELETE de produtos agora verificam que o produto é seu, comissão fora de 0–100% é recusada, e uma atualização parcial não apaga mais suas tags.

2026-07-24

v0.17.3 — Cancelamento de cobrança retorna { canceled: true }

Correção cosmética: DELETE /api/v1/charges/{uuid} agora retorna { "canceled": true } (booleano), como sempre foi documentado, em vez de { "canceled": { "type": true } } — resquício da resposta crua do provedor.

2026-07-24

v0.17.2 — Estorno de PIX (Celcoin) retorna erro claro de "não suportado"

Cobranças PIX processadas pela Celcoin não podem ser estornadas via API — a Celcoin não expõe devolução de PIX. Agora o endpoint de estorno recusa esse caso na hora, com HTTP 422 e o código pix_refund_unsupported, em vez do 409 pix_not_settled (que sugeria, incorretamente, que bastava tentar de novo mais tarde).

2026-07-24

v0.17.1 — Estorno de PIX ainda não liquidado devolve erro claro e reenviável

Ao tentar estornar um PIX que foi pago mas ainda não foi conciliado/liquidado pelo provedor, a API agora responde 409 com o código pix_not_settled e uma mensagem acionável, em vez de repassar um erro genérico. É um estado temporário: basta tentar de novo após a liquidação.

2026-07-22

v0.17.0 — Checkout transparente com /api/v1/charges

Novo recurso /api/v1/charges: crie cobranças PIX, boleto e cartão pela API e receba o código PIX copia-e-cola para renderizar o QR Code dentro do seu próprio checkout. Consultar, listar, estornar e cancelar também entram no v1.

2026-07-19

v0.16.0 — Criação de produtos idempotente

POST /api/v1/products agora aceita X-Idempotency-Key: reenviar a mesma requisição (retry, timeout, duplo clique) devolve o produto já criado em vez de duplicar. O SDK @garuhq/node já manda a chave sozinho.

2026-07-03

v0.15.0 — Aba Taxas simplificada

A aba Taxas passa a focar no que você efetivamente paga. O campo informativo installmentMdr foi removido da resposta de GET /api/seller-config/me — suas taxas efetivas continuam em effective.

2026-07-03

v0.14.3 — Correções no processo de cobrança

Correções no processo de cobrança para deixar o processamento de pagamentos mais preciso e confiável.

2026-06-22

v0.14.2 — Correção: assinatura Pix Automático falhando fora do dia 30

Assinaturas via Pix Automático só conseguiam ser criadas no dia 30 de cada mês — em qualquer outro dia o cliente esbarrava em 'Não foi possível iniciar o Pix Automático'. O dia da cobrança agora é calculado na hora, no fuso de São Paulo, então a assinatura funciona em qualquer dia.

2026-05-31

v0.14.1 — Toggle de Pix Automático no produto + página de Métodos de pagamento

Dois acabamentos que faltavam da v0.14.0: o toggle para ligar/desligar Pix Automático por produto chega no painel, e a nova página pública /metodos-de-pagamento explica em uma só tela como Cartão, Pix, Boleto e Pix Automático se comparam.

2026-05-29

v0.14.0 — Pix Automático nas assinaturas: o cliente assina direto pelo checkout do produto

Pix Automático agora vive dentro do funil de assinaturas: o cliente que entra na página do produto pode escolher Pix Automático ao lado de Cartão e autorizar uma única vez no app do banco. As próximas mensalidades são debitadas sozinhas. É o caminho que finalmente leva a recorrência 'configura e esquece' para a parte do produto que de fato gera receita recorrente.

2026-05-27

v0.13.0 — Pix Automático: assinatura recorrente no débito do banco

Cobranças recorrentes agora aceitam Pix Automático: o cliente autoriza uma única vez no app do banco e os ciclos seguintes são debitados sozinhos — o mesmo 'configura e esquece' do cartão, agora no Pix.

2026-05-25

v0.12.0 — Cobrança resiliente: recuperação automática, skips visíveis e 'Cobrar agora'

O billing de cobranças agendadas deixou de depender de acertar o dia exato: cobranças que perderam o disparo agora são recuperadas automaticamente dentro de uma janela configurável por cobrança, todo skip vira evento visível na timeline (e alerta no Sentry), e o novo botão 'Cobrar agora' dispara a cobrança e a notificação na hora, sem esperar o vencimento.

2026-05-20

v0.11.1 — Cobranças agendadas sem gate silencioso + visual refinado

Removida a flag `scheduled_charges_enabled` que estava silenciosamente bloqueando o disparo de e-mails de cobrança agendada para quase todos os vendedores. A página de detalhes de cobrança agendada também recebeu um polimento alinhado ao restante do painel.

2026-05-18

v0.10.1 — `/api/customers` agora aceita api-key

Todas as rotas de `/api/customers` agora aceitam `sk_live_` / `sk_test_` além do JWT do painel. O controller tinha ficado de fora do rollout de api-key em outras rotas parceiras (c1a478c) e devolvia 401 quando integrações server-to-server tentavam cadastrar um cliente para depois criar uma cobrança recorrente.

2026-05-17

v0.10.0 — Configuração de portal por produto aceita UUID

Endpoints de configuração de portal por produto agora aceitam o UUID do produto além do id numérico legado. UUID é o caminho recomendado — é o identificador não-enumerável retornado por `list_products`. Também substituímos `parseInt` silencioso por validação real: entradas inválidas devolvem 400 em vez de 500.

2026-05-15

v0.9.1 — Correções internas: cron de vínculo de afiliado, observabilidade e ordenação de cobranças

Três correções que não mudam a superfície pública mas estavam minando a confiabilidade do backend: o cron de expiração de vínculos de afiliado voltou a rodar (estava silenciosamente falhando há quatro meses), o filtro global de exceções agora captura erros não tratados, e a ordenação de tentativas de cobrança recorrente passou a usar os nomes corretos das colunas.

2026-05-05

v0.9.0 — Log por tentativa para auditoria de billing recorrente

Cada tentativa de cobrança recorrente agora vira uma linha de log auditável — ciclo 1 interativo, cada cobrança silenciosa, cada retry, cada mark-paid. Inclui endpoint GET /:id/attempts e wrappers de SDK + MCP. Fecha a SPEC §3.1 / §4.2 da v0.8.0.

2026-05-05

v0.8.1 — Endpoint HTTP do gatilho manual de webhook

Expõe o serviço `dispatchManualTestEvent` da v0.8.0 via HTTP — sellers podem disparar payloads de exemplo de qualquer evento já inscrito para validar a integração antes de tráfego real.

2026-05-05

v0.8.0 — Recorrência B2B2C: códigos de falha, vencimento de cartão e portal por produto

Falhas com código normalizado, ciclo de vida de cartão (vencimento + expiração automática), portal customizado por produto para plataformas B2B2C, e gatilho manual de webhook para acelerar integração.

2026-05-05

v0.7.0 — Cobranças recorrentes com cartão e período de teste

Cobranças recorrentes saíram do plano de futuro: cartão salvo no ciclo 1, cobrança silenciosa nos ciclos seguintes, retry e fallback automáticos, período de teste, e ações de ciclo de vida (cancelar recorrência, trocar cartão, marcar ciclo como pago).

2026-05-04

v0.6.0 — Portal do cliente em /minha-area

Seu cliente agora pode ver e pagar todas as cobranças agendadas em um só lugar — sem login, com um link mágico de 24h enviado por e-mail.

2026-05-02

v0.5.0 — Cobranças agendadas

Agende cobranças PIX e Boleto para datas futuras. A Garu manda o e-mail no vencimento, alerta seu time se atrasar, e expõe ações de adiar / pausar / retomar / marcar como paga.

2026-04-30

v0.4.0 — Cadastro de clientes com e-mail de cobrança próprio

Nova página /clientes com cadastro explícito e e-mail de cobrança configurável por cliente — primeiro passo da capacidade de cobranças agendadas.

2026-04-27

v0.3.0 — Veja suas taxas negociadas direto no dashboard

Nova aba Taxas dentro do Financeiro: PIX, cartão, boleto, internacional, chargeback, saque e tabela padrão de MDR por bandeira — tudo o que você negociou, em um só lugar.

2026-04-14

v0.2.2 — Landing animada, docs próprias e páginas /mcp e /cli reescritas

Mural animado na landing, migração de docs para docs.garu.com.br, /mcp e /cli reescritas como páginas de marketing minimalistas, install.sh servido direto de garu.com.br.

2026-04-13

v0.2.0 — Public beta: the agent-first surface is live

Landing page redesign, llms.txt, MCP discovery, 8 per-tool integration pages, full Mintlify docs with agent tools section. Phase 2 complete.

2026-04-09

Phase 1 complete — Agent-first developer surface

Shipped @garuhq/node v0.2.0, @garuhq/cli v0.1.2, @garuhq/mcp v0.1.0, and the garu-skills bundle. The core developer surface is live on npm.