# PIX 概念

FluxiQ PIX 实现的巴西 PIX 即时支付生态系统的基本概念。

## 前提条件

- 对支付系统的基本了解
- 熟悉巴西金融法规有帮助但非必需

## PIX 生态系统概览

PIX 是巴西的即时支付系统，由巴西中央银行 (BCB) 自 2020 年 11 月起运营。它支持 24/7/365 全天候在任意银行账户之间进行 10 秒内的实时转账。

```mermaid
graph TB
    BCB[巴西中央银行]
    BCB --> DICT_SYS[DICT<br/>密钥目录]
    BCB --> SPI_SYS[SPI<br/>即时支付]
    BCB --> MED_SYS[MED 2.0<br/>欺诈追回]

    DICT_SYS --> PART_A[参与者 A<br/>直接]
    DICT_SYS --> PART_B[参与者 B<br/>通过 PSP 间接]
    SPI_SYS --> PART_A
    SPI_SYS --> PART_B
```

## 关键术语

### DICT (交易账户标识符目录)

DICT 是将 PIX 密钥映射到银行账户的集中式目录。支持 5 种密钥类型：

| 密钥类型 | 格式 | 示例 |
|----------|------|------|
| CPF | 11 位数字 | `12345678901` |
| CNPJ | 14 位数字 | `12345678000199` |
| PHONE | +55 + 区号 + 号码 | `+5511999887766` |
| EMAIL | 电子邮箱地址 | `user@example.com` |
| EVP | 随机 UUID v4 | `a1b2c3d4-e5f6-...` |

操作：**创建**、**读取** (查询)、**删除**、**认领** (所有权争议)、**携转** (在机构间迁移)。

### SPI (即时支付系统)

SPI 使用 ISO 20022 格式处理实际支付消息：

| 消息 | 代码 | 用途 |
|------|------|------|
| 贷记转账 | pacs.008 | 发送 PIX 支付 |
| 状态报告 | pacs.002 | 确认或拒绝支付 |
| 退回 | pacs.004 | 退回 (退款) 支付 |
| 状态查询 | pacs.028 | 查询支付状态 |
| 余额查询 | camt.060 | 查询清算余额 |
| 回声请求 | pibr.001 | 连接测试 |
| 回声响应 | pibr.002 | 连接测试响应 |

### ANS (服务级别协议)

BCB 要求 PIX 清算在 **1.6 秒** (1,600 ms) 内完成，从操作接受到清算确认进行测量。FluxiQ PIX 将此作为 `operation_time` 和 `settlement_time` 之间的差值进行跟踪。

- **OK**：差值 <= 1,600 ms (合规)
- **EXCEEDED**：差值 > 1,600 ms (不合规，可能产生罚款)

### MED 2.0 (特殊退回机制)

MED 2.0 是 BCB 用于 PIX 交易欺诈追回的框架。它允许借记方机构通过违规报告请求退回资金。

| 状态 | 描述 |
|------|------|
| OPEN | 报告已创建，等待贷方确认 |
| AWAITING_ANALYSIS | 贷方已确认，等待分析 |
| ANALYSED | 分析完成 (AGREED 或 DISAGREED) |
| CLOSED | 报告已关闭并有解决方案 |
| CANCELLED | 报告已取消 |

### ISPB (参与者标识符)

ISPB 是 BCB 分配给参与巴西支付系统的每个金融机构的 8 位代码。示例：`12345678`。

### 交易状态

| 代码 | 名称 | 描述 |
|------|------|------|
| PDNG | 待处理 | 交易已创建，等待处理 |
| ACSP | 已接受处理 | SPI 正在处理 |
| ACCC | 已接受 | 贷方机构已接受 |
| ACSC | 清算已完成 | 清算已确认 |
| ACTC | 技术已接受 | 技术验证通过 |
| ACWC | 有变更接受 | 带修改接受 |
| STLD | 已清算 | 完全清算 (最终状态) |
| RJCT | 已拒绝 | 被贷方或 BCB 拒绝 |
| CANC | 已取消 | 被借方取消 |
| RTRN | 已退回 | 通过 pacs.004 退回 |

### 清算和净额计算

PIX 对单笔交易进行实时清算，但 BCB 也执行定期的**净额计算** -- 汇总参与者之间的双边头寸以最小化流动性需求。

### COSIF (会计科目表)

COSIF 是 BCB 规定的标准化会计科目表 (Circular 4010)。FluxiQ PIX 实现了 44 个 COSIF 账户，用于正确核算 PIX 操作，包括复式记账分录。

## FluxiQ PIX 映射

| BCB 组件 | FluxiQ 模块 | 服务 |
|----------|-------------|------|
| DICT v2.10.0 | `DictService` | dict_service (:4001) |
| SPI (ISO 20022) | `SpiService` | spi_service (:4002) |
| 清算 | `SettlementService` | settlement_service (:4003) |
| MED 2.0 | `DictService.InfractionReports` | dict_service (通过 Settlement 代理) |
| 认证 / 加密 | `Shared.Auth`、`Shared.Crypto` | shared (库) |
| BACEN 客户端 | `Shared.Bacen` | shared (库) |

## 预期结果

阅读本页后，您应该理解：

- DICT、SPI 和 MED 2.0 在 PIX 生态系统中的作用
- PIX 密钥类型和交易消息格式
- ANS 清算 SLA 及其测量
- FluxiQ PIX 如何映射到 BCB 规范