Garu

2026-07-28

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

apiprodutospix-automaticoassinaturasv1dashboard

Duas correções de coisas que a plataforma dizia fazer e não fazia.

Pix Automático agora liga e desliga de verdade

pixAutomatic existe como coluna no produto desde a v0.14, é devolvido em toda resposta de produto e é verificado no checkout: quem tenta assinar por Pix Automático em um produto com o campo desligado recebe "Pix Automático não está habilitado para este produto."

Só que nenhuma rota aceitava escrever nele. Nem POST/PATCH em /api/v1/products, nem as rotas que o dashboard usa. O campo ficava fora do DTO, então a validação descartava em silêncio: a requisição voltava 200 OK e nada acontecia.

O caso mais visível era a chave Pix Automático no formulário de produto: dava para desligar, salvar, ver "Produto editado com sucesso!" — e ao recarregar a página a chave voltava ligada, porque o valor nunca tinha sido gravado. Na prática todo produto ficava com o padrão da coluna (true) para sempre. A documentação listava pixAutomatic como parâmetro atualizável e o MCP oferecia o campo nas ferramentas de criar e atualizar produto — todas promessas que ninguém cumpria.

Agora o campo é aceito de verdade, tanto pela chave do dashboard quanto pela API:

curl -X PATCH https://garu.com.br/api/v1/products/{uuid} \
  -H "Authorization: Bearer $GARU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pixAutomatic": false}'

Dois detalhes que importam:

  • O padrão é true. Omitir o campo na criação mantém o produto oferecendo Pix Automático, como sempre foi. Só quem enviar false explicitamente sai. (A documentação dizia que o padrão era false — estava errada e foi corrigida.)
  • Desligar não cancela assinatura nenhuma. O campo é lido só na hora de criar uma assinatura nova. Quem já assina por Pix Automático continua sendo cobrado normalmente; o que muda é que ninguém novo consegue assinar por esse meio naquele produto.

Descritor da Fatura saiu do formulário

O formulário de produto tinha um campo Descritor da Fatura, com espaço reservado "Como aparecerá na fatura do cartão" e limite de 22 caracteres. Ele nunca funcionou: não existia coluna no banco, nenhuma integração de pagamento enviava esse dado para a adquirente, e o valor digitado era descartado no momento em que a requisição chegava.

Preferimos tirar o campo a manter uma promessa que a plataforma não tem como cumprir hoje. Quem precisa controlar o que aparece no extrato do comprador deve falar com a gente — depende de suporte da adquirente, e é trabalho que ainda não foi feito.

O campo statementDescriptor também saiu do corpo aceito por POST /api/products. Como ele já era ignorado, enviar não fazia e continua não fazendo diferença.

Impacto

Nenhuma ação necessária. Quem quiser desligar o Pix Automático em algum produto agora consegue, pela API.