Garu

2026-10-15

v0.30.1 — Estorno parcial no saldo certo e cada pagamento na venda certa

financeiroestornosassinaturasapibugfix

Esta versão corrige o Financeiro em dois casos: o estorno parcial e os pagamentos da Celcoin que entravam na venda errada.

Estorno parcial

  • Um estorno parcial agora tira do seu saldo só o valor devolvido. Exemplo: numa venda de R$ 100, você recebe R$ 88,52 líquidos. Depois de um estorno de R$ 30, ficam R$ 58,52 desta venda com você. Antes, o Financeiro tirava a venda inteira.
  • O resto da venda continua retido até a data de liberação original. Antes, ele ficava disponível para saque na hora.
  • As comissões de afiliados e coprodutores voltam na mesma proporção.
  • O estorno total não mudou.

Cada pagamento na venda certa

  • A Celcoin usa números iguais para coisas diferentes: uma cobrança avulsa e um pagamento de assinatura podiam ter o mesmo número. Por isso, um pagamento confirmado podia entrar na venda errada, e a venda certa ficava fora do Financeiro. Agora a Garu separa os dois e aplica cada pagamento só na venda dele.
  • Quando um aviso da Celcoin não aponta para uma única venda, a Garu não aplica nada e registra o caso para a equipe conferir.
  • Um pagamento de assinatura que já chega pago agora entra no seu saldo. Ele entra uma vez só, mesmo quando os dois avisos da Celcoin chegam fora de ordem.

API

  • O estorno e o cancelamento de um pagamento de assinatura Celcoin agora respondem 422, com o código subscription_payment_not_supported. Isso vale para POST /api/v1/charges/{id}/refund e DELETE /api/v1/charges/{id}. Para parar as próximas cobranças, cancele a assinatura. No painel, o estorno desse pagamento mostra o mesmo aviso.