Paygrama guia geral do laboratório de pagamentos

Open Finance

O cliente decide o que fazer com os próprios dados e pagamentos: autoriza, no banco onde tem conta, que outra instituição veja seus dados ou inicie um Pix por ele. Aqui está quem participa, como funciona o consentimento, a iniciação de pagamento, o Pix sem redirecionamento e cada etapa.

Quem participa

Clientedono dos dadosReceptora ou ITPapp que pedeDiretórioquem é quemBanco do clientetransmissora, detentorapedeconsultaAPI + mTLSo cliente aprova no ambiente do próprio banco
O cliente decide; as instituições só conversam com o consentimento dele.

Cliente

Dono dos dados e do dinheiro. Decide o que compartilhar, com quem, por quanto tempo e quais pagamentos autorizar.

Receptora

A instituição que recebe os dados: um app de finanças, outro banco, quem vai conceder crédito.

Iniciadora (ITP)

A instituição que inicia um pagamento a pedido do cliente, como uma loja, uma carteira ou um app. Nunca toca no dinheiro.

Transmissora ou detentora

O banco onde o cliente tem conta: entrega os dados (transmissora) ou executa o pagamento (detentora da conta).

Diretório

O Diretório de Participantes do Open Finance Brasil: quem participa, onde ficam as APIs de cada um e os certificados.

Banco Central

Define as regras, junto com o Conselho Monetário Nacional, e acompanha o funcionamento.

Como funciona o consentimento

1Pedidono app2Consentimentocriado nobanco3Redirecionaao banco4Aprovasenha oubiometria5Voltacom o código6Tokensó o que foiautorizado
Os passos do laboratório, do pedido ao token.

No Open Finance, nada acontece sem o consentimento do cliente, que as regras definem como uma manifestação livre, informada, prévia e inequívoca. A instituição que pede cria o consentimento no banco do cliente, que fica esperando aprovação (AWAITING_AUTHORISATION). O cliente é levado ao app ou ao site do próprio banco, entra com a senha ou a biometria de sempre e aprova (AUTHORISED), ou recusa (REJECTED).

Aprovado, o banco devolve o cliente com um código de uso único, que a instituição troca por um token de acesso. O token vale só para o que foi autorizado e fica preso ao certificado de quem pediu. O cliente pode cancelar o consentimento a qualquer momento, no app ou no banco.

Uma resolução de outubro de 2026 passou a prever também o fluxo de aprovação desacoplado, em que o pedido é feito num lugar e a aprovação acontece depois, no banco, sem redirecionamento automático. Confira a regra em vigor antes de usar este detalhe fora daqui.

Compartilhamento de dados

Com o consentimento, a receptora lê no banco do cliente só os dados permitidos (cadastro, contas, saldos, extrato, cartões, crédito), num formato padronizado, igual em todos os participantes. É o que permite juntar contas de vários bancos num app só, pedir crédito com base no próprio histórico ou comparar ofertas.

No laboratório: caso "Compartilhar dados", com as falhas de recusa e de banco fora do ar. Ver no laboratório

Iniciação de pagamento

A iniciadora de transação de pagamento (ITP) prepara um Pix com valor e recebedor e leva o cliente ao banco para aprovar exatamente aquele pagamento. Depois, manda a ordem ao banco, que executa o Pix pelo SPI como qualquer outro, e avisa quando ele é liquidado. O consentimento de pagamento é consumido (CONSUMED): não serve para outro Pix.

Para a loja, é um Pix sem copiar chave nem ler QR Code; para o cliente, a aprovação acontece no banco dele, onde ele já confia. A iniciadora nunca toca no dinheiro.

No laboratório: caso "Pagar com Pix (iniciação)". Ver no laboratório

Pix sem redirecionamento (JSR) e Pix por aproximação

Uma vez: o vínculoCarteirapede o vínculoApp do bancocliente aprovaDepois, a cada compraAproximao celularCarteiraconfirma no aparelhoBanco do clientesem redirecionarSPIliquida
O redirecionamento ao banco acontece só uma vez, no vínculo.

Na jornada sem redirecionamento, detalhada pelo Banco Central em 2024 (Resoluções BCB nº 406 e 407), o cliente vincula a conta a uma carteira uma vez, aprovando no app do banco. A partir daí, paga sem ser levado ao banco: confirma no próprio celular, e a carteira inicia o Pix com o vínculo, dentro dos limites combinados. É a base do Pix por aproximação, lançado em 2025, que funciona como o pagamento por aproximação de um cartão.

No laboratório: caso "Pix sem redirecionamento (JSR)". Ver no laboratório

Segurança

Certificados ICP-Brasil

Cada instituição tem certificados emitidos por autoridades da ICP-Brasil e se identifica com eles em toda conexão, dos dois lados (mTLS).

Perfil FAPI

Uma versão mais rígida do OAuth 2.0, feita para APIs financeiras, que define como pedir, entregar e usar os tokens.

Token preso ao certificado

O token só funciona junto com o certificado de quem o recebeu: se vazar, não serve para outra instituição.

A senha fica no banco

O cliente só digita a senha ou usa a biometria no ambiente do próprio banco. A instituição que pede nunca vê a senha.

Diretório

Antes de qualquer conexão, as instituições conferem no diretório se a outra é participante e se o certificado é válido.

Arquitetura e sequência

O mesmo cenário em dois desenhos: por quais sistemas a mensagem passa e a ordem das mensagens entre os participantes. Cada empresa organiza os próprios sistemas do seu jeito; esta é uma arquitetura de referência.

ClienteIniciadora (ITP)DiretórioBanco do clienteSPI (BC)PSP recebedor ClienteAppCliente OF (FAPI)TokensDiretório centralParticipantes ecertificadosAPIs Open FinanceAutorização(OAuth)App do bancoConsentimentosContas e saldosCore PixICOM (mensageria)SPIContas PICore PixValidação decontaContasAPI Pix(cobranças)Antifraude e MED 1, 6, 172, 34, 11, 16578, 9, 1012, 1513, 14
Arquitetura de referência para um Pix iniciado pelo Open Finance. Os serviços em destaque tratam alguma mensagem do cenário; os números nas ligações são os passos da sequência abaixo.
ClienteIniciadora (ITP)DiretórioBanco do clienteSPI (BC)PSP recebedor10 msEscolhe pagar pelo Open Finance2300 msConsulta o diretório3420 msEndereços e certificados4700 msCria o consentimento de pagamento5950 msConsentimento criado61,05 sRedireciona para o banco78,7 sAutentica e aprova88,9 sVolta com a autorização99,05 sTroca o código por um token109,2 sToken de acesso119,4 sInicia o pagamento129,5 spacs.008 · Ordem de pagamento139,54 spacs.008 · Repassada149,8 spacs.002 · Aceito159,82 spacs.002 · Liquidado169,88 sPagamento liquidado179,93 sPagamento confirmado
A mesma conversa, mensagem por mensagem. Pago: o cliente aprovou no banco e o Pix de R$ 250,00 foi liquidado em segundos.

No laboratório, os dois desenhos andam passo a passo, com qualquer falha. Ver funcionando

As etapas

O que acontece em cada passo do laboratório e onde ler a regra original. No laboratório, o mesmo texto aparece em "Sobre esta etapa", ao lado do passo.

Consentimento

Nada é compartilhado ou pago sem o consentimento do cliente, que as regras definem como uma manifestação livre, informada, prévia e inequívoca. A instituição cria o pedido no banco do cliente, que fica esperando aprovação; o cliente é levado ao ambiente do próprio banco, entra com a senha ou a biometria de sempre e aprova. Só então o banco libera um código, trocado por um token que vale apenas para o que foi autorizado. O cliente pode cancelar o consentimento a qualquer momento.

Compartilhamento de dados

Com o consentimento autorizado, a receptora lê no banco do cliente (a transmissora) só os dados permitidos, como cadastro, contas, saldos e extrato, num formato padronizado igual em todos os participantes. Isso permite, por exemplo, ver contas de vários bancos num app só ou pedir crédito usando o próprio histórico.

Iniciação de pagamento

Uma iniciadora de transação de pagamento (ITP), como uma loja ou um app, prepara o Pix com valor e recebedor e leva o cliente ao banco para aprovar exatamente aquele pagamento. Depois, manda a ordem ao banco, que executa o Pix pelo SPI como qualquer outro. A iniciadora nunca toca no dinheiro, e o consentimento de pagamento não serve para outro Pix.

Pix sem redirecionamento (JSR)

Na jornada sem redirecionamento, detalhada pelo Banco Central em 2024, o cliente vincula a conta a uma carteira uma vez, aprovando no app do banco. Depois, paga sem ser levado ao banco: confirma no próprio celular, e a carteira inicia o Pix com o vínculo, dentro dos limites combinados. É a base do Pix por aproximação, lançado em 2025.