FVP Manual
Introdução
A FVP Manual tem como objetivo validar, de forma controlada e em ambiente produtivo, se os fluxos e as respostas das APIs implementadas pelas instituições participantes estão em conformidade com os padrões técnicos definidos pelo Open Finance Brasil. Para isso, os testes exigem a autenticação e o consentimento do usuário, garantindo que os comportamentos esperados estejam sendo corretamente executados em ambiente de produção das instituições.
Os testes realizados na FVP (Ferramenta de validação em produção) utilizam dados reais dos usuários em produção, tanto para o compartilhamento de dados quanto para as iniciações de transações de pagamentos. Por padrão, as informações relativas às execuções ficam disponibilizadas nos próprios logs de execução dos testes, sendo deletados da ferramenta após 1 hora do início do teste. Caso os logs de execução sejam baixados, eles estarão com informações sensíveis do usuário. Portanto, pedimos atenção redobrada dos usuários no cuidado com o manuseio e compartilhamento desses arquivos, especialmente quando realizados testes em contas de uso pessoal.
Neste página, você encontrará os seguinte tópicos:
1 - Diferença entre FVP Manual - Testes restritos e Testes abertos: Diferença entre os planos de testes e responsabilidades de execução;
2 - FVP Manual - Testes Abertos: O que é a FVP Manual - Testes Abertos, funcionamento dos ciclos e as responsabilidades de execução dos ciclos pelas instituições;
3 - FVP Manual - Testes Restritos: O que é a FVP Manual - Testes Restritos, funcionamento dos ciclos e módulos de testes que serão validados em produção pela estrutura;
Testes de longa duração: Funcionamento e validação dos testes de longa duração;
4 - Configurando e executando testes: Passo-a-passo para configuração e execução da FVP Manual pelas instituições (Testes Abertos), além de um detalhamento para diferenciação de um teste relacionado à uma pessoa física (PF) ou à uma pessoa jurídica (PJ).
1 - Diferença entre FVP Manual - Testes restritos e Testes abertos
Em geral, a FVP Manual - Testes Restritos representa um conjunto de testes (planos de testes) que podem realizados exclusivamente por membros da Associação Open Finance Brasil e fornecedores, enquanto os planos de testes relacionados à FVP Manual - Testes Abertos podem ser executados pelas próprias instituições.
As execuções dos testes da FVP Manual ocorrem em ciclos mensais, e a responsabilidade de execução da ferramenta depende das contas abertos pelo fornecedor contratado pela estrutura para execução da FVP Manual:
FVP Manual - Testes Abertos: São planos de testes da FVP acessíveis às instituições (Open tests). Caso o fornecedor não possua conta aberta na marca para execução da FVP Manual, a responsabilidade de execução dos testes na FVP Manual - Testes Abertos para o servidor é de responsabilidade da própria instituição.
FVP Manual - Testes Restritos: São planos de testes da FVP exclusivos à estrutura (Restricted test plans). Caso o fornecedor possua conta aberta na marca para execução da FVP Manual, a responsabilidade de execução dos testes na FVP Manual - Testes Restritos para o servidor é de responsabilidade da estrutura.
A relação das contas abertas pelo fornecedor, bem como a responsabilidade de execução mensal para cada servidor, pode ser encontrada no Dashboard da FVP Manual - Relação de Contas Abertas .
2 - FVP Manual - Testes Abertos
Os Testes Abertos permitem que instituições realizem testes em produção em seus próprios servidores, restringindo o acesso para usuários da mesma organização e evitando interferências externas. Para o devido acesso, configuração e execução dos testes da FVP, consulte a seção “4 - Configurando e executando testes“.
Os ciclos de execução da FVP Manual obedecem um ciclo mensal, conforme cronograma de execução abaixo:
Dentro de cada ciclo mensal é esperado que as instituições obtenham sucesso nos testes da FVP Manual - Testes Abertos. Os servidores, segmentos e testes que devem obter sucesso em cada ciclo, dependem dos seguintes critérios :
Servidor: Marcas (servidores) em que o fornecedor contratado não possua conta aberta, a responsabilidade de obtenção de sucesso é da própria instituição, caso esse que caracteriza a necessidade de execução da FVP Manual - Testes Abertos
Segmento suportado (PF e/ou PJ): Para cada segmento suportado pelo servidor (PF e/ou PJ), a instituição deverá obter sucesso nos testes, realizando execuções que são caracterizadas como usuários PF ou PJ. A identificação dos segmentos suportados por cada servidor é baseada nas flags de cada servidor no diretório dos participantes: “Suporta contas PF” e “Suporta contas PJ“
APIs Publicadas: De acordo com as APIs publicadas em cada servidor, serão exigidos sucessos nos testes relativos à essas APIs. A relação de planos e módulos de testes cobrados de acordo com cada API publicada está melhor descrita abaixo.
Segue abaixo a lista de planos e módulos de testes da FVP em que os servidores das instituições deverão obter sucesso completo a cada ciclo mensal, de acordo com as APIs publicadas em cada servidor:
API Pagamentos Automáticos v2.2.0 — Pix Automático: Criação e validação de consentimento, com a realização de dois pagamentos.
Plano de teste: Production Functional Tests for Automatic Pix Payments – API Version 2.2
Módulo de teste: fvp_automatic-payments_api_automatic-pix-semanal-core_open_test-module_v2-2
API Pagamentos Automáticos v2.2.0 — Transferências Inteligentes: Criação e validação de consentimento, com a realização de dois pagamentos.
Plano de teste: Production Functional Tests for Automatic Sweeping Payments – API Version 2.2
Módulo de teste: fvp_automatic-payments_api_sweeping-accounts-core_test-module_v2-2
API Dados do Cliente: Criação de consentimento com prazo indeterminado e execução de chamadas a todas as APIs de Compartilhamento de Dados, conforme as publicações realizadas pela instituição.
Plano de teste: Production Functional Tests for Customer Data Happy Path – API Version 3
Módulo de teste: fvp-customer_data_unique_happy_path_test-module
API Pagamentos v4.0.0: Criação de dois agendamentos customizados (D+1 e D+2), sem cancelamento.
Plano de teste: Production Functional Tests for Payments E2E – API Version 4
Módulo de teste: fvp-payments_api_recurring-payments-custom-not-cancelled_open_test-module_v4
API Vínculo de Dispositivo v2.2.0 (JSR): Execução de pagamento sem redirecionamento, no valor de R$ 0,50 (cinquenta centavos), até o estado liquidado (ACSC).
Plano de teste: Production Functional Tests for No Redirect Payments – API Version 2.2
Módulo de teste: enrollments_api_payments-core_test-module_v2-2
3 - FVP Manual - Testes Restritos
Caso o fornecedor contratado pela estrutura possua conta aberta em sua instituição, o próprio fornecedor é quem será responsável pela execução mensal na FVP Manual - Testes Restritos. Os Testes Restritos (Restricted test plan) possuem acesso exclusivo pela própria estrutura do Open Finance Brasil.
Nos ciclos mensais de execução da FVP Manual - Testes restritos, caso seja identificada uma falha durante a exeucução dos servidores das instituições, um ticket com as evidências das falhas será direcionado às instituições via Service Desk. Para que o ticket seja encerrado, uma reexecução com sucesso do módulo de teste da FVP deve ser obtida exclusivamente pelo fornecedor responsável pela execução dos testes. Para solicitações de pedidos de reexecução, um novo chamado deve ser aberto na categoria: Requisição > Reexecução > FVP Manual - Testes restritos. Para mais informações sobre solicitações de reexecução ou contestações, acesse o Fluxos de Reexecução e Contestação da FVP Manual – Testes Restritos
Abaixo, conforme discussão e definição do Squad Sandbox, está detalhado o ciclo vigente da FVP Manual - Testes Restritos, relativo ao ciclo de Julho de 2026:
Testes de longa duração
Os testes de longa duração, presentes exclusivamente na FVP Manual – Testes Restritos, têm como objetivo validar comportamentos e etapas que ocorrem em dias posteriores à execução inicial do teste. Esses casos se aplicam principalmente a fluxos que envolvem validação da liquidação de pagamentos futuros, tentativas automáticas de retry ou outras ações que não se encerram imediatamente após a execução inicial.
Como os testes de longa duração exigem validações em dias subsequentes à primeira execução bem-sucedida, como a confirmação da liquidação, o sucesso na etapa inicial não significa que o teste tenha sido concluído com sucesso. Os tickets de notificação relacionados a esses testes somente serão encerrados após a conclusão bem-sucedida de todas as etapas subsequentes do fluxo.
Dessa forma, mesmo nos casos de reexecução em que a primeira etapa do teste seja concluída com sucesso, será necessário aguardar o resultado final do teste de longa duração antes de considerar a pendência resolvida. Até que haja resultado da execução subsequente, o SLA do ticket permanecerá pausado. Em caso de sucesso, o ticket será encerrado; em caso de falha, novas evidências serão adicionadas ao ticket e o SLA será retomado.
Software Statements utilizados nos Testes Agendados – Longa duração
Os clients criados a partir dos Software Statements mencionados nesta seção devem ser mantidos no Servidor de Autorização da Instituição, a fim de garantir a persistência das informações necessárias para execuções agendadas ou futuras.
É de responsabilidade da instituição o gerenciamento dos Clients criados para os testes de longa duração, os quais não devem ser deletados nem modificados.
Software Statements cujos clients não devem ser deletados ou modificados:
Os clients associados aos Software Statements abaixo não deverão ser removidos nem alterados, uma vez que o mesmo clientId será utilizado em novos testes.
Software Statement IDs:
44ffd907-2318-496b-ad91-07bbb0a836da.
25402dd0-7553-477b-b635-b9ce79da18f2.
Fluxo de Deleção de Client
Caso a instituição realize a deleção acidental dos clients atrelados aos Software Statements mencionados, será necessária a exclusão desse mesmo client também do lado da ferramenta FVP. Caso contrário, a execução do teste não poderá ser concluída com sucesso.
Para esse tratamento, a instituição deverá abrir um ticket no Service Desk na categoria Requisição > Reexecução e Deleção de Client, informando o ticket vinculado ao teste afetado que requer exclusão.
O ticket original terá o SLA pausado e ficará com o status “AGUARDANDO REEXECUÇÃO/CONTESTAÇÃO”. Se a deleção do client for procedente, em até 5 dias úteis, a deleção será concluída e, após isso, um novo ticket de reexecução poderá ser solicitado internamente, já com direcionamento ao fornecedor, em nome da instituição. Qualquer outro cenário que não seja contemplada a exclusão do client terá tratativa pela equipe técnica com avaliação do caso e deliberado a abertura de um ticket de reexecução ao fornecedor.
Como funcionam os testes Agendados – Longa duração
Execução assíncrona: ao executar um fluxo de teste, podem ser programadas execuções de acompanhamento em datas futuras. Essas execuções ocorrem automaticamente, sem intervenção do usuário.
Persistência: informações críticas, como client_id, consent_id, payment_id e refresh tokens, são armazenadas de forma segura entre as execuções para garantir a continuidade do fluxo.
Temporização de negócio: os testes são alinhados às linhas do tempo reais dos pagamentos, por exemplo, D+2 e D+3, e alguns podem ser restritos a janelas específicas de execução, por exemplo, entre 21:00 e 23:59 BRT.
Salvaguardas automáticas: execuções de acompanhamento somente são agendadas se o fluxo inicial for concluído com sucesso. Caso ocorra erro no início do processo, nenhuma execução adicional será disparada.
Visibilidade: a Estrutura da Associação Open Finance pode visualizar as execuções agendadas, sua origem e seu status, como agendado, executado ou cancelado.
Para identificação dos testes Agendados - Longa duração, seguem abaixo os módulos de produtos executados, contendo de 2 a 3 etapas por teste:
Testes de validação da liquidação de Pix Automático:
Teste 1 de 2: automatic-payments_api_automatic-pix-scheduling_1-2_test-module_v2-2
Teste 2 de 2: automatic-payments_api_automatic-pix-scheduling_2-2_test-module_v2-2
Testes de validação de retrys de Pix Automático:
Teste 1 de 3: automatic-payments_api_automatic-pix-scheduling-retry_1-3_test-module_v2-2
Teste 2 de 3: automatic-payments_api_automatic-pix-scheduling-retry_2-3_test-module_v2-2
Teste 3 de 3: automatic-payments_api_automatic-pix-scheduling-retry_3-3_test-module_v2-2
Testes de validação de Pagamentos Agendados:
Teste 1 de 2: payments_api_scheduled-pix-verification_1-2_test-module_v4
Teste 2 de 2: payments_api_scheduled-pix-verification_2-2_test-module_v4
Testes de validação de JSR - Jornada Sem Redirecionamento - Pagamentos Agendados:
Teste 1 de 2: enrollments_api_payments_scheduled-pix-verification_1-2_test-module_v4
Teste 2 de 2: enrollments_api_payments_scheduled-pix-verification_2-2_test-module_v4
Testes de validação de JSR - Jornada Sem Redirecionamento - Pagamentos Automáticos:
Teste 1 de 2: enrollments_api_automatic-payments_automatic-pix-scheduling_1-2_test-module_v2-2
Teste 2 de 2: enrollments_api_automatic-payments_automatic-pix-scheduling_2-2_test-module_v2-2
Testes de validação de Portabilidade de Crédito:
Teste 1 de 3: credit-portability_api_accepted_settlement_1-3_test-module_v1
Teste 2 de 3: credit-portability_api_accepted_settlement_2-3_test-module_v1
Teste 3 de 3: credit-portability_api_accepted_settlement_3-3_test-module_v1
O detalhamento dos testes completos presentes na FVP Manual podem ser encontrados na página do Gitlab do fornecedor responsável pela ferramenta.
4 - Configurando e executando testes da FVP Manual
a. Criando uma conta no Diretório de Produção
Para acessar a plataforma, é necessário ter uma conta no Ambiente de Produção do Diretório dos Participantes. As instruções para criação da conta estão no Capítulo 03 do Guia Operacional do Diretório de Participantes.
A criação de uma conta envolve assinar os Termos e Condições e configurar um TOTP para futuro acesso. Se houver problemas não resolvidos pelo guia do usuário, é recomendado abrir um ticket de suporte no Service Desk.
b. Escopo de acesso ao Diretório
Para obter acesso ao ambiente da FVP, o usuário deve ser designado com a função "PFVPC" no Ambiente de Produção do Diretório, para a organização que será testada. Caso um usuário que não tenha o papel "PFVPC" no diretória tente executar a ferramente, uma mensagem de erro “403 - FORBIDDEN” aparecerá ao tentar fazer login na plataforma.
Tendo-se em vista que o usuário que irá acessar a FVP deve autorizar consentimentos para as APIs do Open Finance que serão testadas, é necessário que o CPF registrado também tenha acesso aos recursos que serão testados na ferramenta.
c. Acessando a plataforma
Para acessar a plataforma da FVP, o usuário (já com a devida permissão PFVPC) deve realizar o login através do Diretório dos participantes. Após autenticar-se, o usuário deve aceitar os termos e condições da FVP, que aparecerá a cada login na ferramenta.
d. Criando um plano de testes
Após aceitar os termos, o usuário acessará uma interface similar à do motor de conformidade funcional. Nela, o plano de testes desejado deverá ser selecionado e as informações preenchidas conforme instruções abaixo, para testes de Pessoa Física (PF) ou Pessoa Jurídica (PJ):
Testes de Pessoa Física (PF)
Para executar os testes com caracterização de Pessoa Física (PF), o usuário deverá fornecer:
Alias: Deve corresponder ao orgId da organização
Authorisation Server ID: Authorisation Server ID que será testado. O Authorisation Server ID deverá estar registrado no orgId mencionado no campo Alias
BrazilCpf: CPF do usuário atrelado ao usuário logado, o com o devido acesso de PFVPC à organização no diretório dos participantes, conforme mencionado no tópico “Configurando e executando testes”.
A depender do plano de testes executado, outras informações deverão ser fornecidas, como debtorAccount ou creditorAccount
Segue abaixo modelo de configuração base de um plano de testes da FVP Manual para um teste para Pessoa Física (PF):
Se o CPF ou o Authorisation Server ID fornecidos não corresponderem ao do PFVPC cadastrado no diretório dos participantes, a mensagem abaixo será exibida, indicando que a criação do plano de testes não poderá ser realizada.
Testes de Pessoa Jurídica (PJ)
Para executar os testes com caracterização de Pessoa Jurídica (PJ), o usuário deverá fornecer:
Alias: Deve corresponder ao orgId da organização
Authorisation Server ID: Authorisation Server ID que será testado. O Authorisation Server ID deverá estar registrado no orgId mencionado no campo Alias
BrazilCpf: CPF do usuário atrelado ao usuário logado, o com o devido acesso de PFVPC à organização no diretório dos participantes, conforme mencionado no tópico “Configurando e executando testes”.
BrazilCnpj: CNPJ cujo o CPF fornecido possua acesso à conta no servidor testado.
A depender do plano de testes executado, outras informações deverão ser fornecidas, como debtorAccount ou creditorAccount
Segue abaixo modelo de configuração base de um plano de testes da FVP Manual para um teste para Pessoa Jurídica (PJ):