PIX
PIX: arquitetura de referência para liquidação instantânea
O PIX mudou o parâmetro de disponibilidade no mercado financeiro brasileiro: não existe janela de manutenção, não existe "fora do ar por manutenção programada". Qualquer integração precisa operar 24 horas por dia, 7 dias por semana, 365 dias por ano — incluindo Réveillon.
Os três contratos que importam
Uma integração PIX bem-arquitetada trata três contratos como cidadãos de primeira classe:
- Iniciação — o pagador envia a ordem, que precisa ser validada, assinada e roteada ao SPI em milissegundos.
- Recebimento — o recebedor precisa ser notificado e ter o valor refletido no saldo antes que o usuário abra o aplicativo novamente.
- DICT — o diretório de chaves precisa responder consultas de forma consistente, mesmo sob picos de tráfego em datas de alta demanda.
Idempotência não é opcional
Toda mensagem trocada com o SPI pode ser reenviada. Uma arquitetura de core bancário que não trata idempotência de ponta a ponta — do endpoint de API até a escrita no ledger — está exposta a duplicidade de lançamentos. A prática recomendada é:
- Chave de idempotência única por
endToEndId. - Deduplicação na borda (API Gateway) e novamente na escrita do ledger.
- Reprocessamento seguro guiado por máquina de estados, nunca por reprocessamento "cego".
Conciliação como processo contínuo
Conciliação não deveria ser um job de fim de dia. Em uma arquitetura orientada a eventos, cada confirmação do SPI dispara um evento que atualiza simultaneamente o ledger, o extrato do cliente e o barramento de webhooks para parceiros — reduzindo a divergência a segundos, não horas.
O resultado é uma plataforma onde disponibilidade, consistência e velocidade deixam de ser objetivos conflitantes.