Jornada sem redirecionamento – Lançamento da v2.2.0-rc.1 da API Vínculo de dispositivo e v1.3.0-rc.1 da API WebhookLEMBRETE - Disponibilização da versão estável do motor de conformidade para API EmpréstimosDisponibilização do motor v2.2.0-rc.1 da API P...

Informe #772 | 01.08.2025

Jornada sem redirecionamento – Lançamento da v2.2.0-rc.1 da API Vínculo de dispositivo e v1.3.0-rc.1 da API Webhook

Informamos que a área do desenvolvedor do Portal do Open Finance Brasil foi atualizada, em 31/07/2025, com as documentações das versões release candidate das APIs Vínculo de dispositivo (v2.2.0-rc.1) e Webhook (v1.3.0-rc.1).

Dentre as alterações para a API Vínculo de dispositivo v2.2.0-rc.1, destacamos:

Inclusão de motivos de rejeição para representar divergências de titularidades e valores inválidos enviados como "fidoAssertion.response.clientDataJSON.origin";

Novo padrão de CNPJ;

Novas descrições de x-fapi para os erros 5XX.

Adicionalmente, dentre as alterações para a API Webhook v1.3.0-rc.1, destacamos:

Notificações a mudanças de campos específicos para o vínculo de dispositivo;

Novo campo eventType.

O cronograma de certificação e implementação dessas APIs será divulgado posteriormente.

Para acessar todas as alterações e mais detalhes, sugerimos acessar os links de documentação abaixo:

LEMBRETE - Disponibilização da versão estável do motor de conformidade para API Empréstimos

Conforme compartilhado no Informa #716 (“Divulgação do cronograma de certificação e homologação do produto Portabilidade de Crédito Pessoal Clean (CPC)”, divulgado em 28/03/2025), a versão estável do motor de conformidade para API Empréstimos v2.5.0 foi disponibilizada em 01/08/2025, e será utilizada para o marco de 100% em 19/08/2025.

Sucesso no marco de 100%

Para fins de contabilização de sucesso neste marco, as instituições deverão criar um novo plano de testes e reexecutar os seguintes 3 (três) módulos, que sofreram alteração relevante:

loans_api_core_test-module_v2-5;

loans_api_credit-portability_test-module_v2-5;

loans_api_operational-limits_test-module_v2-5.

As instituições que não são credoras originais estão dispensadas da execução do módulo loans_api_credit-portability_test-module_v2-5, mas devem executar os demais.

Ressaltamos ainda que a atualização no diretório deve ocorrer na data do go-live, em 02/09/2025. Mais detalhes sobre os testes podem ser consultados na página de plano de testes (link abaixo).

Por fim, reforçamos que instituições que não obtiverem sucesso no marco serão notificadas via tickets do Service Desk.

Disponibilização do motor v2.2.0-rc.1 da API Pagamentos automáticos

Marco A – Pagamentos automáticos

Conforme divulgado no Informa #767 (“Divulgação do cronograma de implementação da v2.2.0 (minor) da API de Pagamentos Automáticos e lançamento da v2.2.0-rc.1”, publicado em 24/07/2025), será iniciado o processo de certificação da API Pagamentos automáticos. Para contabilização de sucesso no marco A, instituições detentoras de conta devem obter sucesso nos seguintes testes obrigatórios:

Testes com disponibilização prevista para 04/08/2025:

automatic-payments_api_automatic-pix-extraday-core_test-module_v2n1;

automatic-payments_api_automatic-pix-invalid-dates-sooner_test-module_v2n2.

Testes com disponibilização prevista para 11/08/2025:

automatic-payments_api_automatic-pix-invalid-firstPayment-localInstrument_test-module_v2n2;

automatic-payments_api_automatic-pix-semanal-core_test-module_v2n2.

A execução dos módulos deverá ser concluída até 01/09/2025, data final prevista para o marco A.

Os testes selecionados para este primeiro marco refletem mudanças estruturais significativas introduzidas na versão rc.1 da API Pagamentos automáticos. As alterações abrangem:

Introdução do novo endpoint de retry;

Validações relacionadas às restrições no campo localInstrument;

Ajustes no reporte de recorrência por meio do campo paymentReference;

Validações associadas ao fuso horário no campo referenceStartDate.

A seleção dos testes garante cobertura das principais evoluções funcionais da especificação, permitindo uma validação inicial representativa e alinhada aos requisitos regulatórios e técnicos da nova versão.

Mais detalhes sobre os testes podem ser consultados na página de plano de testes (link abaixo).

Processos da FVP Manual – Divulgação de novas páginas para esclarecimento da documentação dos processos

Com o objetivo de esclarecer os processos relacionados à FVP Manual para as instituições, compartilhamos suas novas páginas e painéis de acompanhamento. Estas páginas visam garantir a compreensão dos processos estabelecidos pela Associação com as instituições, trazendo mais transparência quanto às responsabilidades de execução, processos envolvidos, instruções de configuração e execução da ferramenta, e fornecendo uma ferramenta adicional de acompanhamento.

Ao final deste Informa, compartilhamos as três seguintes páginas:

Atualizações da página da FVP Manual: Orientações revisadas, com responsabilidades mais claras no processo de execução dos testes da FVP Manual – Testes Abertos e novos esclarecimentos sobre o funcionamento dos novos testes de longa duração;

Fluxos de reexecução e contestação: Definição detalhada dos processos envolvidos pela Associação e instituições na reexecução de testes ou contestação de resultados da FVP Manual – Testes Restritos;

Painel de execução da FVP Manual: Novo dashboard disponível para acompanhamento das responsabilidades nas execuções da FVP Manual – Testes Abertos (na qual, a execução é de responsabilidade das instituições) ou da FVP Manual – Testes Restritos (na qual, a execução é de responsabilidade da Associação).

Detalhes completos e regras adicionais podem ser consultados em cada página específica, cujos links estão ao final deste Informa.

Para cada página compartilhada, destacamos as principais adições e atualizações:

Atualizações da página da FVP Manual

Ciclo de agosto/setembro-25 da FVP Manual: O próximo ciclo bimestral da FVP Manual ocorrerá de 01/08/2025 até 30/09/2025. Na página da FVP Manual, foram atualizados os planos e módulos de testes que devem ser executados pelas instituições nesse período para obtenção de sucesso na FVP Manual – Testes Abertos, além do detalhamento dos testes que serão executados pela Associação no ciclo da FVP Manual – Testes Restritos;

Execução de testes PF e PJ: Foram fornecidos esclarecimentos e instruções adicionais sobre a execução de testes envolvendo Pessoa Física (PF) e Pessoa Jurídica (PJ) na FVP Manual;

Testes de longa duração na FVP Manual – Testes Restritos: No contexto da FVP Manual Restrita, foi adicionado um novo tópico para esclarecimento do funcionamento dos testes de longa duração, os quais envolvem execuções pré-programadas para dias posteriores como, por exemplo, a validação da criação e liquidação de agendamentos para D+1 e D+2.

Fluxos de reexecução e contestação

Quando e como utilizar: A nova documentação detalha quando e como utilizar o fluxo de reexecução ou contestação de resultados na FVP Manual – Testes Restritos. Além disso, também detalha os processos envolvidos da Associação nas avaliações e tratamentos dos casos dos pedidos de reexecução e contestação, para dar maior transparência às instituições participantes sobre os impactos nos SLAs e cancelamento ou encerramento de tickets relacionados à FVP Manual.

Painel de execução da FVP Manual

Consulta de responsabilidades de execução: No novo painel divulgado, é possível consultar a responsabilidade pela execução bimestral dos testes da FVP Manual para cada servidor de autorização da instituição, segmento (PF ou PJ) e API disponível. Nesse painel, está indicado se a execução de determinado servidor cabe à própria instituição, através da FVP Manual – Testes Abertos, ou ao fornecedor contratado para execução da FVP Manual – Testes Restritos, conforme as contas abertas pelo próprio fornecedor nas instituições até o início de cada ciclo;

Possíveis evoluções: Além da atual informação sobre as responsabilidades de execução da FVP Manual, o mesmo painel poderá ser evoluído para apresentar futuras informações como, por exemplo, consulta de sucessos já obtidos nos testes durante o andamento do próprio ciclo.