Pix no mapa do BIAN
Um Pix de R$ 50 às 23h atravessando os Service Domains da v14.
5 min de leitura
Assista ao documentário desta parte: Parte 1 · O mapa do BIAN (~24 min)São 23h e alguém paga R$ 50 pelo celular. Em poucos segundos o dinheiro sai de uma conta e aparece em outra, num banco diferente. Por trás desse gesto, nove Service Domains do BIAN 14 mudam de estado, e dois sistemas externos, o DICT e o SPI, entram na conversa. Esta aula segue esses R$ 50 passo a passo.
A jornada em nove domínios
O BIAN 14 traz um cenário oficial chamado External Credit Transfer: uma transferência de crédito em que o dinheiro sai do seu banco e chega a uma conta em outra instituição. Pix é exatamente isso, só que em tempo real. Vou usar esse cenário como base e contar a história na ordem em que os domínios entram.
Payment Order Initiation: o cliente abre o app, informa a chave e os R$ 50. Nasce aqui a ordem de pagamento, com seu próprio Control Record.
Payee Management: antes de pagar, o banco precisa saber quem recebe. A chave Pix vira conta, agência e instituição. Como o DICT é operado pelo Banco Central, este domínio funciona como uma fachada: ele guarda a resolução, mas a fonte da verdade é externa.
Payment Orchestration: coordena os próximos passos e sabe em que ponto a ordem está.
Payment Confirmation: checa se a ordem pode seguir. Para pessoa física, o exemplo clássico é o limite noturno de R$ 1.000 após as 20h: às 23h, R$ 50 passam; R$ 1.500 não.
Fraud Evaluation: dá o veredito de fraude sobre a ordem.
Payment Rail: conversa com o trilho externo, o SPI, no formato que ele entende.
Payment Settlement: registra a liquidação confirmada pelo trilho.
Current Account: debita os R$ 50 na conta do pagador.
Position Keeping: registra a posição resultante para o financeiro do banco.
Se você lê artigos antigos e encontra Payment Execution, Payment Order ou Payment Instruction, pare: esses três domínios estão obsoletos na v14. O mapa acima é o atual.
Um Pix de R$ 50 às 23h pelos nove domínios da v14
Fluxo da ordem dentro do banco pagador, com o DICT e o SPI como sistemas externos operados pelo Banco Central.
- Payment Order Initiation · ordem nasce aqui
- Payee Management · fachada do DICT
- Payment Orchestration · coordena os passos
- Payment Confirmation · limite noturno R$ 1.000
- Fraud Evaluation · veredito de fraude
- Payment Rail · fala ISO 20022
- Payment Settlement · liquidação confirmada
- Current Account · débito de R$ 50
- Position Keeping · posição registrada
- DICT · diretório de chaves
- SPI · liquidação bruta em tempo real
Por que o mapa ajuda: cada passo tem dono
A pergunta útil não é "o Pix funciona?", é "quando ele falha às 23h, quem é o dono do passo que falhou?". É aqui que o mapa paga a conta.
Cada domínio da jornada tem um Control Record próprio, aquele registro que vimos na aula 02. A ordem vive em Payment Order Initiation. A resolução da chave vive em Payee Management. O estado da coordenação vive em Payment Orchestration. O veredito vive em Fraud Evaluation. Nenhum deles precisa olhar dentro do outro: cada um expõe o seu estado pela Semantic API e pronto.
Pense em um pipeline de deploy. Você não grava o resultado do teste dentro do artefato de build; cada etapa tem seu log e seu status. Se o deploy quebra, você sabe em qual etapa olhar. A jornada do Pix é a mesma ideia aplicada a dinheiro.
O que isso muda na operação:
- Incidente: "o Pix não caiu" vira "a ordem foi aceita, a chave resolveu, o trilho devolveu
pacs.002de rejeição". Cada frase aponta um domínio. - Fronteira de sistema: quando dois times discutem quem implementa o limite noturno, a resposta está no mapa: Payment Confirmation.
- Auditoria: cada decisão tem registro próprio, com dono. Não existe uma "tabela de pagamentos" gigante onde tudo se mistura.
O custo de manter isso não é o de desenhar o mapa, é o de respeitar a fronteira todos os dias. Um atalho que grava saldo dentro do orquestrador parece inofensivo no sprint e vira dívida permanente em dois anos.
Na prática, o erro que mais vejo em mapeamentos de Pix é colocar o DICT "dentro" de Payee Management, como se o banco fosse dono da chave. Não é. Modele a fachada como fachada: cache com validade, chamada externa explícita e registro de quem consultou o quê. Quando o Banco Central mudar uma regra do DICT, você quer saber em um lugar só onde isso bate.
A jornada do Pix de R$ 50 às 23h
Ordene os domínios do pedido do cliente até o registro da posição.
- 1Fraud Evaluation
- 2Payee Management
- 3Payment Confirmation
- 4Payment Orchestration
- 5Position Keeping
- 6Current Account
- 7Payment Rail
- 8Payment Order Initiation
- 9Payment Settlement
O que é Brasil e o que é igual no mundo
Dois sistemas da história são externos ao banco e são brasileiros: o DICT e o SPI, ambos operados pelo Banco Central.
O DICT é o diretório de chaves. Em muitos países, o equivalente a uma chave Pix fica dentro de cada banco ou num consórcio privado. Aqui, a chave resolve numa fonte central. Por isso Payee Management vira fachada: ele cuida de cache, auditoria e política de uso, mas quem responde "quem é o dono desta chave" é o DICT.
O SPI é o trilho. Segundo o Banco Central, ele faz liquidação bruta em tempo real, transação por transação, e as Contas PI dos participantes não podem ficar com saldo negativo. Isso define o comportamento de Payment Rail e de Payment Settlement: não existe "lote da noite" para compensar depois. Cada Pix liquida sozinho, ou é rejeitado.
As mensagens seguem ISO 20022, e três delas bastam para entender o fluxo:
pacs.008: o pagamento em si, enviado pelo banco pagador.pacs.002: o status, dizendo se o trilho aceitou ou rejeitou.pacs.004: a devolução, quando o dinheiro precisa voltar.
E o que é igual em qualquer pagamento instantâneo do mundo? A jornada dos nove domínios. Iniciar, resolver o recebedor, orquestrar, confirmar limites, avaliar fraude, falar com o trilho, liquidar, debitar e registrar posição: esse esqueleto não muda. Muda o trilho, muda o diretório, mudam os limites regulatórios. Se você mapear um sistema de pagamentos fora do Brasil, troque os nós externos do diagrama e mantenha o resto.
O que levar desta aula
pacs.008, pacs.002 e pacs.004 com o SPI.Checagem rápida
Dúvidas frequentes
O limite noturno de R$ 1.000 é regra do BIAN?
Não. O BIAN diz onde a checagem mora (Payment Confirmation), não qual é o valor. O limite é contexto regulatório brasileiro e é usado aqui só como exemplo de regra que vive nesse domínio.
E a devolução, onde entra no mapa?
Esta aula não cobre o fluxo completo de devolução. O que importa saber: ela chega como pacs.004 pelo trilho e passa pelos mesmos donos, Payment Rail, Payment Settlement, Current Account e Position Keeping, agora com crédito em vez de débito.
Posso simplificar e juntar Orchestration com Confirmation num serviço só?
Pode implementar os dois no mesmo deploy, se o time é um só. O que não pode é misturar os Control Records: o estado da coordenação e a decisão de limite têm ciclos de vida e auditoria diferentes. Fronteira lógica fica; fronteira de deploy é escolha sua.