← Voltar para o blog

Por que (não) construir mais um app de finanças - Parte 4: cartão de crédito e faturas

Parte 4 de 8Série: Por que (não) construir mais um app de finanças
Pássaro roxo pensativo, com a mão no queixo, ao lado de uma pilha de livros, um notebook e grandes pontos de interrogação
Cartão de crédito, ou "fatura é uma lista de gastos".

Uma fatura de cartão parece uma lista: as compras do mês, um total e uma data de vencimento.

Na nossa cabeça, era uma soma com um filtro de data.

34%
das transações no Snabber são de cartão de crédito
5.302
lançamentos que são parcela de alguma compra
3.384
lançamentos de cartão com o sinal trocado, corrigidos num dia só

Esta é a Parte 4 do diário que começamos na Parte 0. Já falamos de Open Finance, de cobrar pelo app e de categorizar gastos. No fim da Parte 3, prometemos explicar por que uma fatura de cartão não é só uma lista de gastos. Chegou a hora.

Contexto rápido: pelo Open Finance, o banco manda as compras do cartão assim que elas acontecem. A fatura em si (total, vencimento, pagamentos) só chega depois que ela fecha.

O que a gente achou que era

O plano original
  1. Somar as compras do mês
  2. Mostrar o total com a data de vencimento
  3. Marcar como paga quando o dinheiro sair da conta

O que realmente era

A compra de setembro que vence em novembro

"As compras do mês" não existe. Existem as compras do ciclo, que vai de um fechamento ao outro. E o vencimento nem sempre cai no mesmo mês do fechamento.

Um exemplo, num cartão que fecha no dia 25 e vence no dia 5:

  1. 1Compra em 28/09. A fatura de setembro já fechou no dia 25.
  2. 2Entra na fatura que fecha em 25/10.
  3. 3Vence em 05/11. O dia 5 vem antes do dia 25, então o vencimento pula para o mês seguinte ao fechamento.

Agora some fevereiro, que não tem dia 30, e fins de semana e feriados, que empurram o fechamento real. Até julho de 2026, o Snabber nem deixava cadastrar um cartão que fecha ou vence no dia 31.

Pelo Open Finance, cada compra também chega com uma previsão do banco sobre o mês em que a fatura vai fechar. Ela costuma acertar mais que o nosso cálculo, então ganha. Mas não sempre:

  • Um emissor, às vezes, mandava a previsão um ciclo atrasada. A conta dava um vencimento anterior à própria compra. Hoje, há uma trava: nenhuma fatura vence antes da compra.
  • Outro mandava "0001-01" quando não sabia. O sync aceitava como mês válido, e cinco transações foram parar numa fatura que venceu em 1901.

A fatura só existe depois que fecha

Enquanto a fatura está aberta, ninguém diz a qual fatura cada compra pertence. O banco só marca isso depois do fechamento. Até lá, o Snabber estima pela data de vencimento calculada acima.

O problema é que a sincronização só atualiza as transações que voltam naquela busca. Se a fatura fechou depois de a compra sair da janela do sync, a compra nunca aprendia de que fatura era. Ficava presa na estimativa para sempre.

A correção foi uma varredura que revisita os últimos 60 dias de cartão e religa cada compra à fatura real. Ela tem uma regra que não pode quebrar: só atualiza, nunca insere. Quando você reconecta o banco, ele pode mandar as mesmas compras com identificadores novos. Uma varredura que inserisse duplicaria meses de histórico. (Em agosto, reconectar já deixava faturas vazias. Não queríamos o problema oposto.)

A parcela de uma compra feita há oito meses

Em outubro, um usuário perguntou para a IA do Snabber sobre os parcelamentos dele. Seis perguntas seguidas. Nas seis, ela procurou "1/10" no texto das descrições, não achou e concluiu que não havia parcela nenhuma. Numa das respostas, sugeriu que ele cadastrasse as parcelas no app.

Os dados estavam lá. Eram 14 lançamentos parcelados, todos com o "3 de 10" que o banco manda em cada um. Só que cada parcela era uma linha solta. Ninguém juntava as parcelas da mesma compra nem projetava as que faltavam.

Juntar parece fácil: mesmo cartão, mesma data de compra, mesmo número de parcelas. Na prática:

  • 8% dos grupos tinham compras iguais no mesmo dia. Duas compras de 3x no mesmo dia, no mesmo cartão, viravam uma. O valor teve que entrar na chave.
  • O valor total da compra quase nunca vem. Só em 48 de 2.704 linhas, todas de uma única instituição. A projeção parte de uma parcela só: se a parcela 3 caiu em outubro, a 7 cai em fevereiro.
  • Às vezes duas parcelas caem na mesma fatura. A 1/2 e a 2/2 juntas. Não dá para assumir "uma por mês" para o que já foi lançado.
  • Alguns emissores mandam as parcelas futuras como transação. Se o Snabber também projetasse essas parcelas, contaria cada uma duas vezes.

E uma compra que para de aparecer (quitação antecipada, estorno, cartão desconectado) sai da projeção em vez de continuar inventando parcelas. Desde 3 de novembro, a fatura estimada é a soma das compras com as parcelas previstas.

Uma fatura não é uma lista de gastos. É uma promessa de pagamento com data marcada.

O estorno que parecia cobrança em dobro

Em 3 de novembro, um usuário escreveu achando que o Snabber tinha cobrado a assinatura duas vezes. Não tinha. Era o estorno.

No cartão, a direção do dinheiro é ao contrário da conta corrente: compra aumenta o que você deve, estorno diminui. Pelo Open Finance, os créditos de cartão (estorno, pagamento de fatura, IOF devolvido, desconto) chegavam com valor negativo. O sync só ajustava o sinal das compras. O estorno entrava como mais um gasto.

Antes
Estorno de R$ 399,90 → −R$ 399,90
mais um gasto na fatura
Agora
Estorno de R$ 399,90 → +R$ 399,90
abate a fatura

A correção do código entrou no mesmo dia. A do histórico também: 3.384 lançamentos de 192 usuários, em 56 segundos, com um identificador de execução para desfazer linha por linha se algo desse errado. Antes, uma simulação mostrou 15 "PAGAMENTO CASHBACK" que seriam tratados como pagamento de fatura. Ajustamos a regra antes de rodar.

No dia seguinte, apareceu a exceção. O banco de testes do nosso provedor de Open Finance manda compras como crédito negativo. A correção virou as compras de teste em entradas. Os bancos de verdade conferidos não fazem isso, mas agora o sync pergunta se a conexão é de teste antes de decidir o sinal.

A fatura paga sai de algum lugar

Na Parte 3, contamos por que o pagamento da fatura não pode contar como gasto: as compras já foram contadas, uma a uma, no cartão. Mas ele precisa contar em outro lugar. Para responder "quanto vou ter na conta no dia 10?", o Snabber precisa saber que a fatura de R$ 2.300 sai da conta corrente no dia 5.

Desde novembro, cada cartão pode ter uma conta de pagamento, e a fatura aparece na previsão do saldo daquela conta. Quando ligamos isso, só 4 de 600 cartões tinham a conta preenchida.

O nosso próprio cartão, devendo R$ 355 mil

Muita gente usa cartão sem conectar ao banco, lançando as compras à mão ou por planilha. Em 22 de outubro, o saldo desses cartões manuais passou de "o último saldo que você digitou" para "um ponto de partida menos as compras desde então". Era a mudança certa. O problema foi o ponto de partida.

A mudança foi para produção sem o passo de transição, que gravaria o saldo antigo como ponto de partida. Cartões com anos de compras importadas passaram a somar tudo. O cartão manual de um de nós amanheceu devendo R$ 355 mil.

Uma ferramenta no painel administrativo gravou o saldo antigo como ponto de partida, cartão por cartão. A lição ficou para as próximas: um passo "antes do deploy" que não trava o deploy não é um passo, é uma sugestão.

Mesmo cartão, duas pessoas

O titular e o adicional pagam a mesma fatura. Mas o casal quer saber quem gastou o quê. O banco manda o final do cartão em quase todas as compras (cerca de 98%), então parecia só agrupar pelos quatro dígitos.

Só que 264 de 314 cartões conectados têm mais de um final, e nem todos são adicionais. Alguns bancos geram um cartão virtual por loja. Desde 4 de novembro, você dá um nome para cada final, e finais com o mesmo nome viram a mesma pessoa. (Dividir as finanças com alguém é o tema da próxima parte.)

snabber-fin
$ git log --oneline -i --grep=fatura
7d8d378f cartão: crédito da Pluggy (estorno, pagamento de fatura) entra positivo
77c6830e previsão: parcelas previstas na fatura estimada + fatura sai da conta de pagamento
cf1de8ef mismatch de data de pagamento de faturas
746c46e8 feat: bloco de parcelamentos na fatura, com parcelas previstas
86cb4450 Corrige faturas vazias depois de reconectar o banco
485b699f Permitir fechamento/vencimento de fatura até o dia 31

Alguns dos 57 commits com "fatura" na mensagem, de abril a novembro de 2026.

O que fizemos

  • ✓Vencimento de cada compra calculado pelo ciclo, com a previsão do banco na frente e uma trava: nenhuma fatura vence antes da compra.
  • ✓Uma varredura que liga compras antigas à fatura real, sem nunca inserir uma linha nova.
  • ✓Parcelamentos agrupados por compra, com as parcelas que faltam previstas na fatura e respondidas pela IA.
  • ✓Estorno e pagamento entrando como crédito, com uma correção do histórico que dá para desfazer.
  • ✓Conta de pagamento do cartão, para a fatura sair do saldo certo na previsão.
  • ✓Gastos por final de cartão, para separar o titular do adicional.

O que ainda não resolvemos

O mesmo cartão pode chegar por duas conexões. Um cliente precisa conectar a bandeira do cartão e o banco, porque cada uma traz contas que a outra não traz. O cartão aparece duas vezes, e hoje não dá para deixar de sincronizar uma conta só de uma conexão ativa. Em produção, achamos mais quatro pares parecidos.

O estorno agora abate a fatura, mas no relatório de categorias ele ainda aparece como "entrada" da categoria, em vez de diminuir o gasto dela.

E, quando o banco ainda não mandou a fatura, a previsão é a soma das compras com as parcelas. Quem sabe que a fatura de dezembro vai ser maior não tem como dizer isso para o Snabber. Ainda.

Se você vai mostrar faturas de cartão

Guarde a data de vencimento de cada compra, não só a data da compra. É ela que decide em que fatura e em que mês aquele dinheiro sai.

E trate o sinal de cada lançamento pelo tipo e pela instituição, nunca por uma regra só. Quando precisar corrigir o histórico, deixe pronto o jeito de desfazer antes de rodar.

Na próxima parte: um casal, uma conta da casa, dois cartões e a pergunta "de quem é isso?".

Suas finanças organizadas sozinhas

Conecte seu banco pelo Open Finance e a Snabber categoriza seus gastos, monta os relatórios e responde suas dúvidas com IA. Crie sua conta grátis, sem cartão de crédito.

Criar conta grátis