Consentimento, participantes, FAPI-BR, APIs padronizadas, iniciação de pagamentos, segurança e operação ponta a ponta
Edição aprofundada - material de estudo e consulta profissional
Por João Ricardo Dutra••Material integral
Brasil: , confiança institucional e padronizadas
Figura de abertura - A jornada combina escolha do cliente, confiança entre participantes e padronizadas.
Princípio central
O cliente controla o , enquanto participantes regulados preservam segurança, interoperabilidade, evidências e responsabilidades ponta a ponta.
Edição aprofundada - material de estudo e consulta profissional
Apresentação do capítulo
O brasileiro é uma infraestrutura regulada de compartilhamento de dados e serviços financeiros por . Sua proposta vai além da abertura de informações bancárias: o cliente pode autorizar que uma instituição receba dados mantidos por outra, iniciar serviços de pagamento e usar essas informações em jornadas de crédito, gestão financeira, investimentos e outros produtos. O valor do ecossistema surge da combinação entre portabilidade informacional, concorrência, inovação e controle pelo titular.
A arquitetura é tecnicamente exigente porque conecta instituições independentes em uma rede de confiança comum. Não basta publicar uma . É necessário identificar participantes, proteger o transporte, autenticar o cliente, registrar , emitir , limitar escopos, padronizar , garantir não repúdio e produzir evidências para monitoramento e auditoria. O erro de uma única camada pode impedir a jornada ou, pior, expor dados de alto valor.
O modelo brasileiro evoluiu a partir do para um escopo mais amplo de . As fases de implantação organizaram historicamente dados abertos, dados cadastrais e transacionais, iniciação de pagamentos e expansão para outros produtos financeiros. Em 2026, o ecossistema continua evoluindo por normas, manuais, agenda técnica e novas capacidades; por isso, profissionais devem distinguir princípios estáveis de versões específicas de e regras operacionais.
Este capítulo conecta os conhecimentos anteriores do curso - 2.0, OpenID Connect, , , , segurança, observabilidade e alta disponibilidade - ao contexto brasileiro. O foco é construir um modelo mental ponta a ponta, útil para arquitetura, desenvolvimento, sustentação e em instituições participantes.
Como estudar este capítulo Acompanhe cada fluxo identificando quatro objetos diferentes: , sessão de autenticação, de acesso e chamada de . Eles se relacionam, mas não são equivalentes. Em produção, cada um possui ciclo de vida, identificadores e evidências próprias.
Objetivos de aprendizagem
Diferenciar e no contexto brasileiro.
Explicar os papéis de cliente, receptor, transmissor, iniciador e .
Descrever a jornada de , autenticação, confirmação e compartilhamento.
Relacionar , certificados, 2.0, , e .
Compreender categorias de , versionamento, idempotência e tratamento de erros.
Analisar iniciação de pagamentos sem confundir jornada, autorização e liquidação.
Aplicar princípios de privacidade, finalidade, minimização e revogação.
Projetar , observabilidade, alta disponibilidade e resposta a incidentes.
Diagnosticar falhas de redirecionamento, certificados, , e .
Estrutura do capítulo
35.1 , e portabilidade de dados
35.2 Evolução e arcabouço regulatório
35.3 Participantes, papéis e fronteiras de responsabilidade
35.4 e experiência do cliente
35.5 , confiança e identidade institucional
35.6 , 2.0, e
35.7 Categorias de e contratos
35.8 Iniciação de pagamentos
35.9 Segurança, privacidade e prevenção a fraudes
35.10 , observabilidade e disponibilidade
35.11 Certificação e monitoramento
35.12 Experiência do cliente e redirecionamentos
35.13 Qualidade, semântica e ciclo de vida dos dados
35.14 Requisitos não funcionais e capacidade
35.15 Versionamento e gestão de mudanças
35.16 ponta a ponta
Resumo, checklist, exercícios, glossário e referências
35.1 , e portabilidade de dados
descreve, em sentido amplo, a abertura controlada de dados e serviços bancários. amplia esse princípio para um conjunto mais abrangente de produtos e relações financeiras. No Brasil, a denominação evoluiu porque o escopo passou a contemplar dados e serviços que ultrapassam conta corrente e cartão, incluindo crédito, investimentos, câmbio, seguros e previdência, conforme a regulamentação e os manuais aplicáveis.
A mudança de nome não elimina a arquitetura original. O núcleo continua sendo o compartilhamento padronizado por , mediante autorização do cliente quando os dados são pessoais ou protegidos. O cliente escolhe quem recebe, de onde os dados saem, para qual finalidade e por quanto tempo. A instituição receptora não recebe acesso irrestrito à conta; recebe apenas os dados ou serviços contemplados pelo e pelo escopo autorizado.
Portabilidade de dados não significa copiar permanentemente toda a vida financeira para um repositório central. A arquitetura é distribuída: os dados permanecem nas instituições que os detêm e são transmitidos, sob demanda, para participantes autorizados. Essa característica reduz centralização, mas exige disponibilidade, interoperabilidade e consistência operacional entre muitas organizações.
Tabela 1 - Os termos se relacionam, mas não são sinônimos perfeitos.
Conceito
Ênfase
Exemplo
Open Banking
Dados e serviços bancários.
Contas, cartões, crédito e pagamentos.
Open Finance
Ecossistema financeiro mais amplo.
Investimentos, seguros, câmbio e previdência, conforme escopo vigente.
Open API
Interface publicada com regras de acesso.
API padronizada para dados ou serviço financeiro.
Portabilidade informacional
Cliente controla o deslocamento dos dados.
Compartilhar histórico para obter proposta melhor.
35.2 Evolução e arcabouço regulatório
A implementação brasileira foi organizada em etapas. A primeira concentrou dados abertos de produtos, canais e serviços. A segunda introduziu compartilhamento de dados cadastrais e transacionais mediante . A terceira incorporou iniciação de pagamentos e encaminhamento de propostas. A quarta expandiu o escopo para outros produtos financeiros. Essa divisão é útil como visão histórica, embora o ecossistema atual seja mantido por uma agenda evolutiva contínua.
O marco central é a Resolução Conjunta nº 1, de 4 de maio de 2020, posteriormente alterada por outras normas. O Banco Central divulga manuais técnicos e operacionais que detalham , experiência do cliente, segurança, serviços, escopo e monitoramento. Em 2026, novas instruções normativas continuaram atualizando esses manuais, o que reforça a necessidade de consultar a versão vigente antes de implementar ou promover mudanças.
A Estrutura de Governança coordena especificações, , certificações, monitoramento e processos comuns. As instituições continuam responsáveis por seus sistemas, dados, autenticação, segurança e atendimento regulatório. Governança compartilhada não transfere a responsabilidade individual por falhas de proteção ou indisponibilidade.
Tabela 2 - As fases explicam a evolução, mas a operação atual é contínua e versionada.
Etapa histórica
Conteúdo predominante
Impacto arquitetural
Dados abertos
Produtos, tarifas, canais e características.
APIs públicas, catálogo e padronização.
Dados do cliente
Cadastro e transações com consentimento.
OAuth, identidade, escopo e privacidade.
Serviços
Iniciação de pagamentos e outras jornadas.
Idempotência, status, antifraude e alta disponibilidade.
Expansão
Outros produtos e dados financeiros.
Mais domínios, versões e integração intersetorial.
35.3 Participantes, papéis e fronteiras de responsabilidade
Uma mesma instituição pode exercer mais de um papel. Como transmissora, disponibiliza dados que mantém. Como receptora, recebe dados autorizados para oferecer serviços. Como iniciadora de transação de pagamento, conduz a jornada e envia uma ordem autorizada, sem deter os fundos. Como detentora de conta, autentica o cliente, valida a autorização e executa o pagamento conforme as regras aplicáveis.
Os papéis devem ser modelados por função, não apenas por marca. Um conglomerado pode possuir entidades jurídicas distintas, cada qual com certificados, registros e responsabilidades próprias. O roteamento e a autorização precisam respeitar o participante exato, o ambiente, a organização e o software cadastrado, evitando assumir que todo componente de um grupo financeiro compartilha automaticamente a mesma identidade.
Também existem componentes comuns, como , ferramentas de certificação, monitoramento e portais de especificação. Esses serviços criam interoperabilidade, mas não substituem os controles internos de cada participante. A instituição deve garantir que suas , portais, certificados, credenciais e processos estejam atualizados e operacionais.
Tabela 3 - O diagnóstico deve registrar qual papel cada instituição exercia na transação.
Papel
Responsabilidade principal
Evidência operacional
Transmissor de dados
Disponibilizar dados autorizados e padronizados.
Logs de consentimento, token e chamadas.
Receptor de dados
Solicitar e usar dados conforme finalidade.
Registro da jornada e base legal.
Iniciador de pagamento
Criar a jornada e transmitir a ordem.
Consentimento, idempotência e status.
Detentor de conta
Autenticar e executar o pagamento.
Confirmação, antifraude e retorno.
35.4 e experiência do cliente
O é uma autorização explícita para finalidades e condições determinadas. Ele não deve ser confundido com autenticação. A autenticação prova a identidade do cliente perante a instituição; o registra a decisão sobre dados ou serviços. A jornada precisa permitir que o cliente compreenda quem receberá os dados, quais categorias serão compartilhadas, por quanto tempo e para que finalidade.
A experiência normalmente começa na instituição receptora. O cliente seleciona a instituição de origem e é redirecionado para um canal controlado por ela. Nesse ambiente, autentica-se com os mecanismos habituais e confirma a autorização. Depois, retorna à instituição receptora, que conclui a troca de e inicia as chamadas. O receptor não deve coletar a senha usada no transmissor.
Revogação e expiração são partes do ciclo de vida. Encerrar o impede novas chamadas amparadas por ele, mas não apaga automaticamente dados já recebidos quando existe obrigação ou outra base legal para retenção. A governança de dados precisa separar permissão para coletar, finalidade de uso, retenção, anonimização e descarte.
Figura 1 - , autenticação e chamada de são etapas relacionadas, porém independentes.
Regra de segurança A senha ou fator de autenticação do banco de origem deve ser informado apenas no ambiente controlado por essa instituição. A instituição receptora trabalha com redirecionamento, e , não com captura de credenciais bancárias.
35.5 , confiança e identidade institucional
O ecossistema depende de uma infraestrutura de confiança capaz de responder quem é o participante, quais funções exerce, quais softwares foram registrados, quais pertencem a ele e quais certificados estão associados à identidade. O cumpre papel central nessa descoberta e no estabelecimento de relações verificáveis entre organizações.
Certificados e chaves precisam ser tratados como ativos de produção. Rotação, expiração, revogação, cadeia de confiança e associação ao ambiente correto devem ser monitoradas. Um certificado válido criptograficamente pode ser inadequado se estiver vinculado a outra organização, outro software ou outra finalidade. Por isso, validação de identidade não termina na assinatura; inclui metadados e registros do ecossistema.
A confiança também é versionada. Mudanças de certificados, , perfis de software e participantes precisam propagar-se sem janelas de inconsistência. Ambientes de homologação e produção não devem compartilhar segredos ou certificados de forma indiscriminada.
Figura 2 - Confiança institucional combina registro, criptografia, protocolos e evidências operacionais.
35.6 , 2.0, OpenID Connect e
financeiras lidam com dados e operações de alto risco. O perfil de segurança brasileiro, conhecido como , acrescenta requisitos ao 2.0 e ao OpenID Connect para reduzir interceptação de códigos, adulteração de parâmetros, clientes falsos e reutilização de . O perfil vigente deve ser consultado porque versões e períodos de convivência fazem parte da evolução técnica do ecossistema.
A jornada envolve servidor de autorização, cliente registrado e resource server. O cliente inicia uma autorização; o servidor autentica o usuário e vincula a transação ao ; depois, emite para acesso às . Mecanismos como , parâmetros assinados, autorização empurrada, autenticação forte do cliente e vinculados ao certificado podem participar do perfil, conforme a versão aplicável.
protege o transporte e também pode vincular o ao certificado do cliente. Nesse modelo, roubar o não é suficiente: o atacante também precisaria demonstrar posse da chave privada correspondente. O deve validar a cadeia, identidade, associação com o software registrado e confirmação presente no , além de issuer, audience, expiração e escopos.
OpenID Connect apoia a autenticação e a entrega de de identidade no fluxo de autorização. Entretanto, de dados devem validar , não utilizar como substitutos genéricos. A separação entre autenticação do usuário, autorização do cliente e acesso ao recurso continua essencial.
Tabela 4 - Segurança é composta por camadas; nenhum mecanismo isolado resolve todo o problema.
Camada
Mecanismo
Responsabilidade
Transporte
TLS e mTLS
Confidencialidade, integridade e identidade de ponta.
Autorização
OAuth 2.0 / FAPI-BR
Delegação, tokens, escopos e proteção do fluxo.
Identidade
OpenID Connect
Autenticação e claims sobre o usuário.
Mensagem
JWT/JWS/JWE
Assinatura, integridade e eventual confidencialidade.
Ecossistema
Diretório e certificados
Identidade institucional e descoberta confiável.
35.7 Categorias de e contratos
O catálogo do organiza por grupos de dados e serviços. Entre as categorias recorrentes estão canais e produtos, dados cadastrais, contas, cartões, operações de crédito, investimentos, câmbio, seguros, previdência, consentimentos, recursos e pagamentos. A disponibilidade e a versão exata devem ser verificadas no catálogo oficial vigente.
As especificações padronizam nomes, campos, tipos, paginação, cabeçalhos, erros e requisitos não funcionais. Isso reduz ambiguidades entre instituições, mas não elimina diferenças de dados de origem. Sistemas legados podem representar datas, saldos, contratos e titulares de formas distintas. A camada de adaptação deve preservar semântica, não apenas converter nomes de campos.
Versionamento exige convivência planejada. Uma instituição pode precisar suportar mais de uma versão durante migrações, executar testes de conformidade e comunicar mudanças a consumidores. O ajuda no roteamento, mas compatibilidade real depende de , contrato, documentação e observabilidade.
Exemplo conceitual de chamada de dados /open-banking/accounts/vX/accounts/{accountId}/balances /1.1 Host: .instituicao.example Authorization: <access- > X-Fapi-Interaction-Id: < > Accept: application/ # O caminho e os cabeçalhos exatos dependem da versão vigente da especificação.
35.8 Iniciação de pagamentos
A iniciação de pagamento permite que uma instituição autorizada crie a experiência e transmita a ordem para a instituição onde o cliente mantém a conta. O iniciador não precisa custodiar os fundos. O cliente escolhe a conta, autentica-se no detentor e confirma a operação. A execução financeira ocorre no arranjo e nos prestadores envolvidos, enquanto o iniciador acompanha estados e apresenta o resultado.
Do ponto de vista de , a jornada exige idempotência, correlação e máquina de estados. Repetir uma requisição por não pode criar pagamentos duplicados. O identificador de idempotência precisa estar associado ao conteúdo e a uma janela definida. Estados intermediários devem ser tratados como parte do contrato: pendente, aceito, rejeitado, concluído ou cancelado podem exigir consultas ou notificações posteriores.
Segurança antifraude não desaparece. Detentor e iniciador aplicam seus próprios controles, respeitando a experiência regulada. Sinais como dispositivo, comportamento, risco, valor, favorecido e histórico podem levar a autenticação adicional ou rejeição. A arquitetura precisa evitar vazamento de detalhes que ajudem atacantes a calibrar tentativas.
Iniciação de pagamento: separação entre jornada e movimentação dos fundos
Figura 3 - O iniciador orquestra a jornada, mas a instituição detentora executa a movimentação dos fundos.
35.9 Segurança, privacidade e prevenção a fraudes
Dados financeiros possuem alto valor e podem revelar renda, hábitos, localização indireta, relacionamentos e saúde financeira. O princípio de minimização exige solicitar apenas categorias necessárias à finalidade apresentada. O receptor deve impedir uso secundário incompatível, limitar acesso interno e registrar quem consultou ou processou os dados.
A LGPD se aplica junto à regulamentação setorial. no é um mecanismo operacional e regulatório específico, mas o tratamento posterior ainda precisa respeitar finalidade, transparência, segurança e direitos do titular. Segredos, , certificados e não devem aparecer integralmente em , ferramentas de suporte ou ambientes de teste.
Ameaças incluem phishing durante redirecionamento, aplicativos falsos, roubo de , abuso de consentimentos, enumeração de recursos, fraude de pagamento, , e comprometimento de certificados. Controles eficazes combinam validação de redirect , , curtos, audience restrita, idempotência, detecção comportamental e resposta rápida a incidentes.
Tabela 5 - Cada ameaça precisa de controle preventivo e evidência verificável.
Ameaça
Controle principal
Evidência
Aplicativo ou participante falso
Diretório, certificados e validação de cliente.
Identidade e software registrados.
Token roubado
mTLS/sender-constrained, audience e expiração curta.
Falha de binding ou uso anômalo.
Consentimento abusivo
Finalidade, escopo, prazo e revogação.
Registro da jornada e telas apresentadas.
Pagamento duplicado
Idempotência e máquina de estados.
Mesma chave e mesmo conteúdo.
Vazamento em logs
Mascaramento e minimização.
Logs sem tokens ou dados sensíveis completos.
35.10 , observabilidade e alta disponibilidade
O concentra controles de transporte, validação de certificados, , , roteamento, transformação e auditoria. Entretanto, ele não deve assumir sozinho regras de negócio do . O precisa verificar vínculo entre recurso, cliente, titular e escopo. Caso contrário, uma configuração equivocada no pode abrir acesso indevido.
Observabilidade deve correlacionar , consent ID, client ID, organização, , versão da , , status, latência e . e dados pessoais devem ser mascarados. Métricas agregadas revelam disponibilidade e desempenho; ajudam a separar tempo no , servidor de autorização, adaptador e legado.
Alta disponibilidade é requisito sistêmico. Uma instituição pode estar saudável internamente e ainda falhar por , certificado, , dependência de autorização ou . , e circuit breakers precisam considerar idempotência e natureza da operação. Repetir leitura pode ser seguro; repetir criação de pagamento sem chave correta pode ser desastroso.
Arquitetura de borda para reguladas
Figura 4 - O aplica controles de borda, enquanto e autorização de negócio permanecem fim a fim.
35.11 Certificação, monitoramento e conformidade
O ecossistema utiliza mecanismos de certificação funcional e de segurança para aumentar interoperabilidade. A aprovação em testes não garante operação permanente: mudanças de versão, certificados, dependências e infraestrutura podem introduzir regressões. Por isso, conformidade precisa estar integrada ao CI/CD, com testes automatizados e validação antes de cada promoção.
Monitoramento comum e indicadores permitem identificar indisponibilidade, degradação e diferenças de comportamento entre participantes. Em 2026, o Banco Central atualizou manuais de monitoramento e segurança, reforçando revisão periódica de configurações, serviços expostos e controles de autenticação e autorização. A equipe deve acompanhar normas e agenda evolutiva, não apenas o backlog interno.
Evidências de conformidade incluem configuração publicada, versão da , certificado ativo, resultado de testes, de jornada, métricas, incidentes e planos de correção. A ausência de trilha auditável transforma problemas técnicos em riscos regulatórios.
35.12 Experiência do cliente e redirecionamentos
A experiência do cliente é parte do protocolo operacional. Redirecionamentos entre aplicativos e navegadores precisam preservar contexto sem expor credenciais. A interface deve deixar claro qual instituição recebe os dados, qual transmite, quais dados serão usados e por quanto tempo. Ambiguidade visual aumenta risco de phishing e abandono da jornada.
Jornadas app-to-app e web-to-app exigem deep links, universal links ou mecanismos equivalentes configurados com domínio e aplicativo corretos. O parâmetro state protege a correlação e ajuda a impedir substituição de sessão. A aplicação deve tratar cancelamento, retorno sem código, expiração, mudança de dispositivo e retomada da jornada de forma previsível.
A autenticação ocorre no ambiente da instituição transmissora ou detentora. O receptor não deve imitar a tela do outro banco nem solicitar sua senha. Mensagens de erro também precisam evitar termos internos e informar ao cliente qual etapa falhou, sem revelar detalhes de segurança.
Tabela 6 - A experiência segura precisa prever caminhos de erro e cancelamento.
Situação
Tratamento esperado
Risco evitado
Usuário cancela
Retornar estado controlado e não criar consentimento.
Consentimento fantasma.
Deep link inválido
Bloquear retorno e orientar nova tentativa.
Sequestro de redirecionamento.
state divergente
Rejeitar a resposta.
CSRF e troca de sessão.
Sessão expirada
Reiniciar autorização com contexto claro.
Uso de sessão obsoleta.
35.13 Qualidade, semântica e ciclo de vida dos dados
Interoperabilidade não significa apenas válido. Campos precisam conservar significado entre instituições. Saldo disponível, saldo bloqueado, limite, data de contratação e situação de contrato podem ter regras distintas nos sistemas de origem. O adaptador deve aplicar a semântica da especificação e documentar limitações, evitando preencher campos com valores aproximados apenas para satisfazer o .
Qualidade inclui completude, consistência, atualidade, unicidade e rastreabilidade. Quando um dado não existe ou não se aplica, a representação deve seguir o contrato. Null, campo ausente, zero e string vazia não são equivalentes. Erros sistemáticos de mapeamento podem produzir decisões de crédito incorretas mesmo quando a está disponível.
O receptor também precisa governar os dados após a coleta. Deve registrar origem, , finalidade, data de obtenção, transformações e regras de retenção. Quando o expira ou é revogado, novas coletas cessam; o tratamento dos dados já recebidos deve seguir obrigações legais, contratuais e políticas de descarte.
35.14 Requisitos não funcionais e capacidade
As especificações do ecossistema incluem requisitos não funcionais como disponibilidade, latência, limites de tráfego, monitoramento e comportamento de erro. Esses parâmetros variam por grupo de e versão. O planejamento de capacidade deve considerar rajadas de consentimentos, agregadores que consultam várias instituições, fechamentos mensais e novas funcionalidades regulatórias.
precisa proteger a plataforma sem interromper consumidores legítimos. A chave de limite pode combinar organização, software, , e . Contadores locais são simples, mas podem permitir excesso em múltiplas instâncias; contadores globais melhoram consistência e acrescentam latência e dependência.
A estratégia de disponibilidade deve incluir zonas independentes, renovação de certificados, rotação de chaves, replicação de configurações e testes de contingência. O objetivo não é apenas manter o respondendo, mas preservar autenticação, autorização, dados atualizados e status confiáveis durante falhas parciais.
Tabela 7 - Disponibilidade técnica sem qualidade ou segurança não representa sucesso.
Dimensão
Indicador
Pergunta operacional
Disponibilidade
Sucesso por API e participante.
A jornada completa está disponível?
Latência
Percentis por endpoint e backend.
Onde o tempo está sendo consumido?
Capacidade
RPS, concorrência e filas.
Há margem para rajadas e retries?
Qualidade
Campos ausentes e divergências.
A resposta está semanticamente correta?
Segurança
Falhas de token, mTLS e fraude.
O controle está bloqueando o risco certo?
35.15 Versionamento e gestão de mudanças
O catálogo diferencia versões atuais, candidatas e períodos de convivência. Uma nova versão pode alterar , , requisitos de segurança ou regras não funcionais. A instituição precisa inventariar consumidores e dependências internas, atualizar mocks, contratos, , e observabilidade antes da data obrigatória.
Mudanças devem entrar por . Linting, testes de contrato, testes funcionais, certificação, segurança e performance precisam ser executados com a mesma configuração que chegará à produção. Exceções manuais devem ter prazo e responsável. A documentação deve informar qual versão está ativa, qual está em retirada e como identificar tráfego remanescente.
Períodos de convivência não devem virar suporte indefinido. Telemetria por versão, organização e software ajuda a confirmar migração. A retirada só deve ocorrer quando requisitos regulatórios, comunicação e evidências técnicas estiverem alinhados.
Governança de mudança Trate norma, manual, especificação e configuração de como artefatos versionados. Uma alteração regulatória só termina quando código, certificados, testes, documentação, monitoramento e runbooks também foram atualizados.
35.16 ponta a ponta
Falhas de precisam ser classificadas pela etapa. Se a instituição não aparece para seleção, investigue , cadastro e descoberta. Se o redirecionamento falha, verifique redirect , estado, navegador, aplicativo e deep link. Se o não é emitido, avalie autorização, , autenticação do cliente, certificado e . Se a retorna 401 ou 403, valide issuer, audience, escopo, binding e recurso.
Erros de exigem inspeção de cadeia, validade, hostname, certificado apresentado, e associação da identidade. podem estar em , , , servidor de autorização, , adaptador ou legado. O deve acompanhar a investigação entre organizações, preservando dados mínimos e evitando envio de completos em chamados.
Em pagamentos, diferencie erro de criação, autorização, execução e consulta de status. Um do cliente não prova falha financeira. Antes de repetir, consulte o estado usando os identificadores do contrato. O runbook deve dizer quando é permitido, quando reconciliação é obrigatória e quando intervenção manual é necessária.
Tabela 6 - O diagnóstico começa pela etapa, não pelo produto apontado pelo usuário.
Sintoma
Hipóteses
Evidências prioritárias
Instituição não aparece
Diretório, cadastro, cache ou ambiente.
Registro do participante e discovery.
Falha no redirect
URI divergente, state, app link ou sessão.
Authorization request e logs do canal.
invalidclient
Certificado, private_key_jwt ou cadastro.
Metadados e identidade do software.
401 na API
Token inválido, audience ou mTLS binding.
Claims, certificado e logs do gateway.
Pagamento duplicado
Idempotência ausente ou retry incorreto.
Chave, payload e histórico de estados.
35.17 Estudos de caso e laboratórios
Estudo de caso 1 - Agregador financeiro: uma instituição receptora obtém para contas e cartões mantidos em dois bancos. O normaliza os dados e apresenta visão consolidada. O risco principal não é apenas disponibilidade; é preservar significado, moeda, datas, titularidade e finalidade ao combinar fontes diferentes.
Estudo de caso 2 - Iniciação de Pix: o cliente inicia a jornada em um aplicativo terceiro, autentica-se no banco detentor e confirma o pagamento. O iniciador recebe status pendente após . A estratégia correta é consultar o recurso pelo identificador e reconciliar o estado, não criar uma segunda ordem sem verificar idempotência.
Estudo de caso 3 - Rotação de certificado: o novo certificado foi publicado, mas uma instância do manteve antigo. Parte das chamadas falha de modo intermitente. A investigação combina , nó atendente, horário, e rollout da configuração.
Laboratórios sugeridos 1) Desenhe uma jornada com , autorização e separadas. 2) Valide um conceitual com issuer, audience, expiração e confirmação de certificado. 3) Simule uma falha de e registre evidências por camada. 4) Modele estados e idempotência de uma iniciação de pagamento.
Resumo do capítulo
Brasil é uma infraestrutura regulada e distribuída que combina escolha do cliente, identidade institucional, , autenticação, e padronizadas. representa a origem e parte do escopo; amplia a visão para outros produtos e serviços financeiros.
A segurança depende de camadas: , certificados, , 2.0, OpenID Connect, , contratos, monitoramento e controles internos. não substitui autenticação, e não substitui autorização de negócio. A instituição deve validar todas as relações até o recurso solicitado.
Operar o ecossistema exige versionamento, certificação, observabilidade, alta disponibilidade, privacidade e resposta coordenada a incidentes. Como normas e manuais continuam evoluindo, arquitetos e operadores precisam tratar documentação oficial e agenda regulatória como dependências de produção.
Próximo passo do curso O próximo capítulo aprofunda a LGPD aplicada às , conectando fundamentos jurídicos e técnicos de finalidade, minimização, direitos do titular, segurança, retenção e governança de dados.
Checklist de arquitetura e operação
Papéis de receptor, transmissor, iniciador e detentor estão explicitamente identificados.
, autenticação, e chamada de possuem correlação e ciclo de vida próprios.
, certificados, e software statements estão atualizados.
Issuer, audience, escopos, expiração e binding de são validados.
não expõem , credenciais ou dados financeiros completos.
Idempotência e reconciliação estão definidas para operações de pagamento.
Versionamento e períodos de convivência são tratados no e no .
Runbooks cobrem , , , , , e legado.
Testes de certificação e regressão fazem parte do .
Normas, manuais e agenda evolutiva são monitorados por responsáveis definidos.
Exercícios
Diferencie e no contexto brasileiro.
Explique por que e autenticação são objetos diferentes.
Descreva o fluxo entre instituição receptora, transmissora e cliente.
Explique o papel do na confiança entre participantes.
Relacione , 2.0, e .
Explique por que não deve ser usado como genérico.
Modele uma estratégia de idempotência para iniciação de pagamento.
Liste evidências necessárias para diagnosticar uma falha 401.
Proponha métricas e para uma de dados de contas.
Descreva os impactos de uma rotação de certificado incompleta.
Glossário
Tabela 7 - Vocabulário essencial do capítulo.
Termo
Definição
Consentimento
Autorização explícita do cliente para finalidade, escopo e duração determinados.
Detentor de conta
Instituição que mantém a conta e executa a transação autorizada.
Diretório
Infraestrutura de cadastro e descoberta de participantes, software e certificados.
FAPI-BR
Perfil brasileiro de segurança para APIs financeiras baseado no ecossistema FAPI.
Iniciador de pagamento
Participante que inicia a jornada sem deter os fundos.
Interaction ID
Identificador de correlação usado nas interações de API.
Open Banking
Abertura regulada de dados e serviços bancários.
Open Finance
Ampliação do compartilhamento para um ecossistema financeiro mais abrangente.
Receptor de dados
Participante que recebe dados conforme autorização do cliente.
Transmissor de dados
Participante que disponibiliza dados que mantém.
mTLS
TLS mútuo, com autenticação por certificado nos dois lados.
Sender-constrained token
Token cuja utilização depende de prova da chave associada.
Referências técnicas
Banco Central do Brasil. - visão geral, segurança, clientes e participantes.
Resolução Conjunta nº 1, de 4 de maio de 2020, e alterações posteriores.
Banco Central do Brasil. Manual de do - versão vigente.
Banco Central do Brasil. Manual de Segurança do - versão vigente.
Banco Central do Brasil. Manual de Experiência do Cliente - versão vigente.
Banco Central do Brasil. Manual de Monitoramento do - versão vigente.
Brasil. Área do Desenvolvedor e Catálogo de .
Brasil. Financial-grade Security Profile - .
e OpenID Foundation. 2.0, OpenID Connect, , PAR, JAR, JARM e FAPI.
Lei nº 13.709/2018 - Lei Geral de Proteção de Dados Pessoais.
Nota de atualização Este capítulo apresenta princípios e arquitetura com base em fontes oficiais consultadas em julho de 2026. Antes de implementar, confirme sempre a versão vigente das normas, manuais, , perfis de segurança e períodos de convivência publicados pelo Banco Central e pela Estrutura de Governança do .