PIX:即时结算的参考架构

PIX 改变了巴西金融市场对可用性的要求:不存在维护窗口,也不存在"计划性维护暂时下线"这种说法。任何集成都必须做到全年 365 天、每天 24 小时不间断运行——包括跨年夜。

三个至关重要的契约

一个架构良好的 PIX 集成会将三个契约视为头等公民:

1. 发起 —— 付款方提交指令后,必须在几毫秒内完成校验、签名并路由到 SPI。
2. 接收 —— 收款方需要被及时通知,并且在其再次打开应用之前,金额就应已反映在余额中。
3. DICT —— 密钥目录需要在高需求日期的流量高峰下,依然保持一致、可靠的查询响应。

幂等性不是可选项

与 SPI 交换的每一条消息都可能被重发。如果核心银行架构没有从 API 端点到总账写入的全链路幂等性处理,就会暴露在重复记账的风险之下。最佳实践包括:

• 每个 endToEndId 对应唯一的幂等键。
• 在边缘层(API 网关)进行去重,并在总账写入时再次去重。
• 由状态机驱动的安全重处理,而不是"盲目"的重试。

将对账作为持续性流程

对账不应该是一个日终批处理任务。在事件驱动架构中,SPI 的每一次确认都会触发一个事件,同时更新总账、客户账单以及合作伙伴的 Webhook 总线——将差异从数小时缩短到几秒钟。

最终结果是:可用性、一致性与速度不再是相互冲突的目标,而是同一套平台的三个支柱。