PIX 范围内交易简介
间接参与者的客户(Alias)可以请求 PIX 范围内与交易相关的多种功能。其中包括:
PIX 转账类型(pix_transfer_type)
| 枚举值 | 描述 |
|---|---|
| manual | 使用目标账户数据的 PIX。必须发送 target_account。 |
| key | 使用 PIX 密钥的 PIX。必须发送 target_pix_key。如果进行了 PIX 密钥查询,建议发送查询返回的 end_to_end_id。 |
| static_qr_code | 使用静态 QR 码的 PIX。必须发送 QR 码解码 返回的 end_to_end_id。 |
| dynamic_qr_code | 使用动态 QR 码的 PIX。必须发送 QR 码解码 返回的 end_to_end_id。 |
| reversal | PIX 退款。 |
在这些功能中,间接参与者可以根据需求选择交易的"同步性"类型。
信息
本简介部分所描述的所有内容,以及间接参与者应如何通过 API 进行处理,均在后续各节中详细说明。
端到端 ID
每笔 PIX 交易在中央银行都有一个唯一标识符。端到端 ID(End to End ID)是 PIX 转账的端到端标识符,用于控制巴西中央银行的速率限制。
每个个人或法人注册都在巴西中央银行拥有一个令牌桶。PIX 密钥查询请求会消耗该桶中的令牌,当执行与查询关联的 PIX 交易时,令牌会被归还。PIX 密钥查询与交易之间的关联通过端到端 ID 建立。
交易同步性
间接参与者可以选择以同步或异步方式执行 PIX 交易。在两种模式下,PIX 交易都将在巴西中央银行规定的时间内执行。
信息
我们的团队将根据与客户商定的情况配置要使用的同步性模式。
信息
同步和异步模式的端点、方法、负载和其他请求组件完全相同。区别仅在于,对于异步模式,如果通过初始验证,响应始终是状态为 pending 的 pix_transfer。随后将发送一个 webhook,告知交易的最终状态(sent 或 rejected)。
交易重试
由于巴西中央银行消息系统在处理 PIX 交易时可能出现延迟,QI Tech 对同步和异步模式的 PIX 交易都提供了重试机制。
如果出现此情况,间接参与者将收到 HTTP 202 状态码,表示交易已发送至 QI Tech,正等待巴西中央银行确认。重试完成后,间接参与者将通过 webhook 获知交易的执行情况。