Open Finance e Open Banking no Brasil
Voltar para Learn
FAACCapítulo 35

Fundamentos e Arquitetura de APIs Corporativas

Open Finance e Open Banking no Brasil

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

Ecossistema brasileiro de Open Finance conectando cliente, instituições, consentimento e APIs seguras

Brasil: , confiança institucional e padronizadas

Cliente autorizando compartilhamento seguro entre instituições financeiras por APIs
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ÊnfaseExemplo
Open BankingDados e serviços bancários.Contas, cartões, crédito e pagamentos.
Open FinanceEcossistema financeiro mais amplo.Investimentos, seguros, câmbio e previdência, conforme escopo vigente.
Open APIInterface publicada com regras de acesso.API padronizada para dados ou serviço financeiro.
Portabilidade informacionalCliente 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óricaConteúdo predominanteImpacto arquitetural
Dados abertosProdutos, tarifas, canais e características.APIs públicas, catálogo e padronização.
Dados do clienteCadastro e transações com consentimento.OAuth, identidade, escopo e privacidade.
ServiçosIniciação de pagamentos e outras jornadas.Idempotência, status, antifraude e alta disponibilidade.
ExpansãoOutros 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.
PapelResponsabilidade principalEvidência operacional
Transmissor de dadosDisponibilizar dados autorizados e padronizados.Logs de consentimento, token e chamadas.
Receptor de dadosSolicitar e usar dados conforme finalidade.Registro da jornada e base legal.
Iniciador de pagamentoCriar a jornada e transmitir a ordem.Consentimento, idempotência e status.
Detentor de contaAutenticar 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.

Consentimento, autenticação e chamada de API como etapas independentes
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.

Diretório e confiança institucional conectando participantes por criptografia e protocolos
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.
CamadaMecanismoResponsabilidade
TransporteTLS e mTLSConfidencialidade, integridade e identidade de ponta.
AutorizaçãoOAuth 2.0 / FAPI-BRDelegação, tokens, escopos e proteção do fluxo.
IdentidadeOpenID ConnectAutenticação e claims sobre o usuário.
MensagemJWT/JWS/JWEAssinatura, integridade e eventual confidencialidade.
EcossistemaDiretório e certificadosIdentidade 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

Iniciador de pagamento orquestrando jornada executada pela instituição detentora
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çaControle principalEvidência
Aplicativo ou participante falsoDiretório, certificados e validação de cliente.Identidade e software registrados.
Token roubadomTLS/sender-constrained, audience e expiração curta.Falha de binding ou uso anômalo.
Consentimento abusivoFinalidade, escopo, prazo e revogação.Registro da jornada e telas apresentadas.
Pagamento duplicadoIdempotência e máquina de estados.Mesma chave e mesmo conteúdo.
Vazamento em logsMascaramento 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

API Gateway aplicando controles de borda em uma jornada autorizada fim a fim
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çãoTratamento esperadoRisco evitado
Usuário cancelaRetornar estado controlado e não criar consentimento.Consentimento fantasma.
Deep link inválidoBloquear retorno e orientar nova tentativa.Sequestro de redirecionamento.
state divergenteRejeitar a resposta.CSRF e troca de sessão.
Sessão expiradaReiniciar 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ãoIndicadorPergunta operacional
DisponibilidadeSucesso por API e participante.A jornada completa está disponível?
LatênciaPercentis por endpoint e backend.Onde o tempo está sendo consumido?
CapacidadeRPS, concorrência e filas.Há margem para rajadas e retries?
QualidadeCampos ausentes e divergências.A resposta está semanticamente correta?
SegurançaFalhas 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.
SintomaHipótesesEvidências prioritárias
Instituição não apareceDiretório, cadastro, cache ou ambiente.Registro do participante e discovery.
Falha no redirectURI divergente, state, app link ou sessão.Authorization request e logs do canal.
invalidclientCertificado, private_key_jwt ou cadastro.Metadados e identidade do software.
401 na APIToken inválido, audience ou mTLS binding.Claims, certificado e logs do gateway.
Pagamento duplicadoIdempotê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.
TermoDefinição
ConsentimentoAutorização explícita do cliente para finalidade, escopo e duração determinados.
Detentor de contaInstituição que mantém a conta e executa a transação autorizada.
DiretórioInfraestrutura de cadastro e descoberta de participantes, software e certificados.
FAPI-BRPerfil brasileiro de segurança para APIs financeiras baseado no ecossistema FAPI.
Iniciador de pagamentoParticipante que inicia a jornada sem deter os fundos.
Interaction IDIdentificador de correlação usado nas interações de API.
Open BankingAbertura regulada de dados e serviços bancários.
Open FinanceAmpliação do compartilhamento para um ecossistema financeiro mais abrangente.
Receptor de dadosParticipante que recebe dados conforme autorização do cliente.
Transmissor de dadosParticipante que disponibiliza dados que mantém.
mTLSTLS mútuo, com autenticação por certificado nos dois lados.
Sender-constrained tokenToken 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 .