Aparência
Novidades
Resumo das mudanças da API, da mais recente para a mais antiga. O histórico completo, com detalhes técnicos, está no CHANGELOG.md do repositório.
17 de novembro de 2026
Só a Fidúcia (breaking change para contas do banco Teste)
O banco simulado Teste foi removido: a única integração bancária é a Fidúcia, em homologação (sandbox) ou produção. Contas que ainda estavam no banco Teste ficam com o banco desligado. Para testar sem dinheiro real, use uma conta na homologação da Fidúcia.
Rotas duplicadas removidas
| Removida | Use |
|---|---|
PUT /access/accounts | PUT /access/account |
POST /consolidation/statistic/balance | POST /consolidation/statistic/cards |
GET /enums/type-transactions | GET /consolidation/transaction-types |
4 de outubro de 2026
Idempotency-Key na criação de cobrança e no Pix out
As rotas que criam cobrança e as que enviam Pix aceitam o header opcional Idempotency-Key. A mesma requisição repetida com o mesmo código não é executada de novo: a API devolve a resposta da primeira. Ver Idempotência.
Rotas de Pix out renomeadas (breaking change)
Agora tudo fica sob /banking/pix/transfers, e os destinatários ficam em /banking/pix/recipients. As rotas antigas foram removidas:
POST transfers→POST transfers/lookup;transfers/confirm→transfers/key;transfers/bank-data→transfers/bank-account;copy-paste/pay→transfers/copy-paste;copy-paste/decode→transfers/copy-paste/decode;transfers/recipients*→recipients*.
Ver Transferências Pix.
3 de outubro de 2026
Reenvio de webhook da cobrança em /billing/charges/{id}/webhook
POST /quickpay/webhooks/send-charge/{chargeId} virou POST /billing/charges/{id}/webhook (breaking change; a antiga responde 404, e o prefixo /quickpay deixou de existir). Corrigido junto: a rota antiga aceitava cobrança de outra conta e dava erro em cobrança só Pix. Ver Cobranças Pix e boleto.
Limpeza de código morto (controllers, requests, resources, mails...)
Foram apagados 98 classes e 8 views sem uso real. Nenhuma rota existente mudou (as mesmas 284 rotas). Jobs de webhook e jobs ainda usados em outras branches foram mantidos. As páginas de rotas que não existiam (rateios, estatísticas de cobrança, IPs autorizados) viraram avisos.
Limpeza de código morto (services)
Foram apagados 7 services sem uso, além de 4 controllers e 4 requests que só eles usavam:
- os services de dashboard e relatórios (
DashboardService,DashboardSummaryService,BillingReportService,CustomerReportService), cujas rotas/consolidation/dashboard,/consolidation/dashboard/summarye/billing/reportsnunca foram registradas; ChargeSearchService,EvolutionApiServiceeStricService.
Nenhuma rota existente mudou. As páginas que descreviam essas rotas foram corrigidas.
Rotas de cobrança do /quickpay unificadas em /billing/charges
GET /quickpay/charges/reports(e o duplicado/quickpay/chargess/reports) →GET /billing/charges/reports, mesma resposta.- Removidas sem rota nova, porque já existiam em
/billing/charges:GET /quickpay/charges/{id}/download(useGET /billing/charges/{id}/download-pdf) ePOST /quickpay/charges/{id}/notify(usePOST /billing/charges/{id}/notify). - Removida
GET /quickpay/charges/export, sem uso.
Transações e extrato só em /consolidation/financial-movements
As rotas duplicadas /quickpay/transactions, /quickpay/transactions/balance-summary, /quickpay/transactions/{id}, /quickpay/transactions/{id}/download e /quickpay/extract foram removidas (respondem 404). Nenhum portal as usava. O equivalente é /consolidation/financial-movements, com tabela de migração em Módulo Financeiro.
Pagamento de boletos em /banking/boleto/payments (breaking change)
O pagamento de boletos de terceiros saiu de /quickpay/boleto/* e foi para /banking/boleto/payments (decode, pay, lista e detalhe), no padrão do Pix copia e cola. As rotas antigas respondem 404.
- Correções: o bloqueio de pagamento duplo não funcionava; não havia checagem de saldo; uma falha no registro depois do pagamento no banco podia permitir pagar de novo. Agora o pagamento fica "em processamento" antes de chamar o banco.
- Aceita linha digitável com pontuação. PIN inválido, saldo insuficiente, boleto já pago e banco sem suporte respondem
422. - Sem taxa, como antes. Disponível no Sicoob e no Teste.
- Detalhes e tabela de migração: Pagamento de boletos.
2 de outubro de 2026
Cancelar cobrança sem excluir
Nova rota POST /billing/charges/{id}/cancel: a cobrança pendente vai para Cancelado e continua visível. Antes, o boleto é baixado no banco; se o banco recusar, nada muda (422). Detalhes em Cobranças Pix e boleto.
Pix e boleto unificados em /billing/charges (breaking change)
Cobranças por Pix, boleto e BOLEPIX são emitidas, listadas, baixadas em PDF e canceladas só por /billing/charges. Toda a emissão e a baixa no banco ficam num único serviço.
- Removidas (respondem
404):/banking/pix/charges(listar, criar, consultar) e o CRUD de boletos em/quickpay/boletose/quickpay/boleto/{create,list,cancel,pdf,{txid}}. Tabela de migração: Cobranças Pix e boleto. - Novo em
POST /billing/charges: Pix sem cliente e sem vencimento; multa (late_fee,late_fee_type) e mensagens (informative) no boleto. - Novo em
DELETE /billing/charges/{id}: pede a baixa do boleto pendente no banco e cancela o Pix pendente. - Correções:
boleto.digitable_lineno detalhe da cobrança vinha semprenull.GET /quickpay/boleto/paymentsera capturado porboleto/{txid}. - Continuam: QR estático (
/banking/pix/static-qrcode) e pagamento de boletos de terceiros (/quickpay/boleto/payments,payment-barcode,info-barcode). - Impacto: integrações que usavam as rotas removidas precisam migrar. O portal foi atualizado no mesmo ciclo.
30 de setembro de 2026
Pix unificado em /banking/pix (breaking change)
Todas as rotas de Pix que operam direto no banco da conta passam a ficar em /banking/pix: chaves, cobranças, copia e cola e transferências. As rotas antigas foram removidas e respondem 404. Corpo e resposta de cada rota não mudaram, só o caminho.
- Tabela completa de migração: Banking — visão geral.
- Removidas também as rotas legadas da Sicredi (
quickpay/saida-sicred,quickpay/pix-out/dataBank,quickpay/boleto-saida-sicred,quickpay/pix/lookup,quickpay/pixout/*). - Boletos e links de pagamento continuam em
/quickpay. Os webhooks dos bancos não mudaram. - Correção:
GET /banking/pix/transfers/recipientsagora devolve os destinatários. Na rota antiga,recipientsera capturado porwithdraws/{id}. - Impacto: integrações por token de API que usavam as rotas antigas precisam trocar os caminhos. O portal foi atualizado no mesmo ciclo.
Pagamento de Pix copia e cola
Novas rotas POST /banking/pix/copy-paste/decode (prévia: chave, valor, recebedor) e POST /banking/pix/copy-paste/pay (pagamento com PIN, valida saldo, taxa e limite). Disponível hoje só no banco Teste; nos demais bancos, 422. Documentação
Simulação Pix completa no banco Teste
Contas do banco Teste ganham um DICT simulado:
- 6 chaves Pix liberadas, uma delas simulando recusa;
- chave fora da lista retorna
404(antes, qualquer chave era aceita); - 3 códigos copia e cola válidos (CRC16 conferido);
- Pix por dados bancários devolve como recebedor os dados informados (antes, esses dados iam para o pagador);
- o Pix gerado para receber passa a ser um BR Code válido.
Ambiente de teste (banco Teste, removido em 17/11/2026)
Limpeza: routes/groups/api_pix.php
O arquivo nunca foi registrado, então suas rotas (/pix/lookup, /pix/send, /pix/send-direct, /pix/charges) nunca existiram em produção. Todas já tinham equivalente em /banking/pix e foram apagadas, junto com os controllers e as requests que só elas usavam. Nenhuma rota em produção mudou.
Mudanças no portal (fastgivr-portal)
Para contexto de quem integra e dá suporte:
- Carteira → Transferir agora oferece Pix com chave, Pix copia e cola e Pix com dados bancários.
- Novo Receber via Pix na Carteira: gera QR Code e código copia e cola (
POST /banking/pix/charges). - Correção: a tela de sucesso do Pix por chave quebrava depois do envio, porque a confirmação devolve o comprovante com
valorerecebedor, e a tela liavalueename. A resposta agora é normalizada no portal. A API não mudou.