Histórico de alterações e atualizações da API LURI v2:

Data Tipo Título da Mudança
08/11/2026 Nova Funcionalidade Consulta de Saldo em Tempo Real (GET /v2/accounts/{account_id}/balance) e Extrato Direto no Liquidante (GET /v2/accounts/{account_id}/statements)
Disponibilizado o novo endpoint GET /v2/accounts/{account_id}/balance (escopo api.ext api.conta.saldo) para consulta em tempo real do saldo disponível, bloqueado e agendado diretamente no liquidante BaaS (api/Conta/Saldo). O endpoint GET /v2/accounts/{account_id}/statements (escopo api.ext api.conta.extrato) passa a consultar o extrato diretamente no BaaS (api/Conta/Extrato), mantendo 100% de retrocompatibilidade com o payload da Luri v2 e adicionando o resumo de saldos do período em items.balance (saldo_inicial, saldo_final, saldo_disponivel, saldo_bloqueado), novos filtros padronizados (seller_id, seller_ein, created_date_gte, created_date_lte, operacao, d_c, dt_mov) e fallback automático dos últimos 30 dias quando nenhum filtro de data é informado.
08/11/2026 Nova Funcionalidade Webhooks de Eventos em Conta (account.* — Escopo Exclusivo JWT)
Implementado o envio de Webhooks de Eventos em Conta (account.pix.received para Pix avulso na chave, account.pix.sent, account.pix.refunded, account.pix.reversed, account.pix.failed, account.ted.received, account.ted.sent, account.ted.refunded, account.transfer.received, account.transfer.sent, account.bill_payment.*, account.utility_payment.*, account.service_fee, account.split, account.boleto.credit_preview, account.boleto.protested, account.card.*, account.cnab.* e fallback dinâmico) exclusivamente para marketplaces que possuam url_webhook configurada e credencial JWT ativa (/v2/auth/public-keys), mantendo os webhooks de cobrança (boleto.* e pix.*) disponíveis no escopo Basic Auth + JWT.
06/11/2026 Nova Funcionalidade Conciliação Ativa de Pagamentos Pix (GET /v2/charge/pix/{id}/payments), Novos Encargos cobv e Webhook pix.created
Disponibilizado o endpoint GET /v2/charge/pix/{id}/payments para consulta direta dos pagamentos e devoluções do QR Code na instituição liquidante (DetalhesPagamento) com conciliação ativa automática (fallback). Expandidas as opções de encargos no Pix cobv com suporte a todas as modalidades de juros (interest_mode: valor por dia corrido ou útil, percentual diário ou mensal em dias corridos ou úteis, e isento) e descontos por antecipação em discount[].mode (anticipation_fixed_calendar, anticipation_fixed_business, anticipation_percentage_calendar, anticipation_percentage_business). Adicionado o disparo automático do webhook pix.created na criação de cobranças em POST /v2/charge/pix e enriquecido o payload de pix.paid com e2e_id (NumeroOperacao), movement_id (CodigoMovimento), transaction_id e dados do pagador (payer).
06/11/2026 Melhoria Detalhamento dos Tipos e Payloads de Webhooks na Documentação
Documentação completa de todos os tipos de eventos de Webhook enviados pela plataforma LURI v2: eventos de cobrança (boleto.created, boleto.registered, boleto.failed, boleto.updated, boleto.canceled, boleto.paid para boletos e boletos híbridos, pix.paid para cobranças Pix puras em /v2/charge/pix, e boleto.assign) e eventos de segurança de chaves públicas (public_key.created e public_key.revoked), incluindo exemplos completos de payload e política de retentativas.
06/11/2026 Nova Funcionalidade Identificação de Parcelas (installment) em Boleto e Pix (/v2/charge e /v2/charge/pix)
Adicionado suporte ao objeto opcional installment ({ "number": 1, "total": 12 }) na criação e consulta de Boletos (POST /v2/charge, GET /v2/charge) e Pix (POST /v2/charge/pix, GET /v2/charge/pix) para identificar estruturadamente a parcela atual e a quantidade total de parcelas da venda, com integração direta na geração de PDF/HTML de boletos (/v2/print) e retrocompatibilidade com etiquetas em tags.
06/11/2026 Nova Funcionalidade Atualização de Boletos (PATCH /v2/charge/{id}) e Consulta Geral Pix (/v2/charge/pix/all)
Disponibilizado o endpoint PATCH /v2/charge/{id} para alteração de boletos registrados (valor nominal, vencimento, data limite de pagamento, multa, juros, descontos, abatimento e sacador avalista receiver) e a rota GET /v2/charge/pix/all para consulta consolidada de cobranças Pix emitidas por seller_id.
06/11/2026 Melhoria Padronização de Encargos em "Centavos" e Novos Campos em Boleto e Pix (/v2/charge e /v2/charge/pix)
Unificação da convenção de valores monetários e percentuais em billing_instructions como inteiros representando duas casas decimais ("centavos"): late_fee_amount, late_fee_percentage, late_fee_date, interest_amount, interest_percentage, interest_date, abatement_amount e array discount (suportando descontos fixos ou percentuais até a data de vencimento tanto em Boleto quanto em Pix cobv). Adicionado suporte normalizado ao Sacador Avalista (payment_method.receiver), espécie e número do documento (document_species, document_number), parâmetros de expiração e alteração no Pix Dinâmico (expiration_seconds, allow_amount_change, payer_request) e tornado payment_limit_date opcional com fallback automático de +90 dias, mantendo compatibilidade com o formato legado.
23/10/2026 Nova Funcionalidade Gerenciamento de Webhooks RESTful (/v2/webhooks)
Lançamento dos endpoints RESTful de gerenciamento self-service de notificações de webhook: POST /v2/webhooks (cadastro e atualização da URL com geração de webhook_secret criptográfico), GET /v2/webhooks (consulta da configuração ativa com indicador has_secret) e DELETE /v2/webhooks/{hash_marketplace} (exclusão segura do webhook e invalidação do segredo).
23/10/2026 Nova Funcionalidade Gerenciamento de Chaves Públicas Assimétricas (/v2/auth/public-keys)
Lançamento dos endpoints de ciclo de vida de chaves públicas assimétricas RSA (RS256): POST /v2/auth/public-keys (cadastro de chave PEM via Basic Auth com TLS 1.2+ obrigatório), GET /v2/auth/public-keys (listagem de chaves ativas, revogadas e legadas via JWT) e DELETE /v2/auth/public-keys/{kid} (revogação de chave com trava de segurança anti-lockout via JWT).
18/09/2026 Nova Funcionalidade Consulta Geral BaaS(/v2/charge/all)
Disponibilizada a rota GET /v2/charge/all para consulta geral e unificada de todos os boletos e cobranças emitidos na conta bancária. Exige o parâmetro seller_id e suporta paginação e filtros por datas de emissão, vencimento e status.
18/09/2026 Melhoria Busca por Código de Barras e Fallback em /v2/charge/
O endpoint GET /v2/charge/ foi atualizado para permitir consultas além do boleto_id, suportando busca por seller_id + linha_cod_barras (44 dígitos numéricos) ou nosso_numero / reference_id, incluindo fallback automático de consulta direta no banco emissor.
09/09/2026 Nova Funcionalidade Endpoint de Impressão de Boletos (/v2/print)
Disponibilizada a rota GET /v2/print/:layout/:formato/:seller/:boleto para impressão e download de boletos nos layouts boleto, double e triple, e nos formatos html, pdf e base64. Inclui suporte a chave EMV e QRcode Pix.
08/09/2026 Correção Nome objeto boleto_id no response de criação.
Corrigido nome do objeto "boleto_id" no response de criação de boleto, para refletir mesmo valor do legado (v1). Na versão anterior estava erroneamente como "id_boleto".
14/08/2026 Nova Funcionalidade Endpoints de Cobrança Pix (Estático, Dinâmico e Cobrança)
Lançamento da nova API Pix sob a rota /v2/charge/pix com auto-detecção de modalidade, provisionamento automático de chave EMV e listagem unificada.
27/07/2026 Nova Funcionalidade Estrutura Categorizada de Leads
Adicionada a nova estrutura com os objetos lead, contact e o campo source no endpoint POST /v2/lead/.
27/07/2026 Nova Funcionalidade Autenticação JWT no Endpoint de Lead
O endpoint POST /v2/lead/ passa a aceitar autenticação via JWT (Bearer Token) assinado com algoritmo RS256, além de manter suporte ao Basic Auth.
27/07/2026 Nova Funcionalidade API de Contas e Extratos (Accounts & Statements)
Disponibilização dos endpoints GET /v2/accounts/ (Listar Contas) e GET /v2/accounts/{account_id}/statements (Listar Extratos Bancários).
27/07/2026 Nova Funcionalidade Assinatura HMAC SHA-256 em Webhooks
Notificações de Webhook agora enviam os cabeçalhos X-Webhook-Signature e X-Webhook-Timestamp quando uma secret_key estiver configurada.