跳到主要内容

PIX 范围内交易简介

间接参与者的客户（Alias）可以请求 PIX 范围内与交易相关的多种功能。其中包括：

  • 手动 PIX 交易
  • 通过密钥进行 PIX 交易
  • PIX QRCode 交易
  • 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。
    reversalPIX 退款。

    在这些功能中，间接参与者可以根据需求选择交易的"同步性"类型。

    信息

    本简介部分所描述的所有内容，以及间接参与者应如何通过 API 进行处理，均在后续各节中详细说明。

    端到端 ID​

    每笔 PIX 交易在中央银行都有一个唯一标识符。端到端 ID（End to End ID）是 PIX 转账的端到端标识符，用于控制巴西中央银行的速率限制。

    sequenceDiagram
        Participante Indireto->>+Banco Central: Consulta de Chave Pix
        Banco Central-->>-Participante Indireto: Chave Pix + End to End ID da consulta <br> Token consumida do bucket
        Participante Indireto->>+Banco Central: Transferência com End to End ID
        Banco Central-->>-Participante Indireto: Sucesso na transação com chave pix <br> Token devolvido ao bucket

    每个个人或法人注册都在巴西中央银行拥有一个令牌桶。PIX 密钥查询请求会消耗该桶中的令牌，当执行与查询关联的 PIX 交易时，令牌会被归还。PIX 密钥查询与交易之间的关联通过端到端 ID 建立。

    交易同步性​

    间接参与者可以选择以同步或异步方式执行 PIX 交易。在两种模式下，PIX 交易都将在巴西中央银行规定的时间内执行。

    信息

    我们的团队将根据与客户商定的情况配置要使用的同步性模式。

    信息

    同步和异步模式的端点、方法、负载和其他请求组件完全相同。区别仅在于，对于异步模式，如果通过初始验证，响应始终是状态为 pending 的 pix_transfer。随后将发送一个 webhook，告知交易的最终状态（sent 或 rejected）。

    交易重试​

    由于巴西中央银行消息系统在处理 PIX 交易时可能出现延迟，QI Tech 对同步和异步模式的 PIX 交易都提供了重试机制。

    如果出现此情况，间接参与者将收到 HTTP 202 状态码，表示交易已发送至 QI Tech，正等待巴西中央银行确认。重试完成后，间接参与者将通过 webhook 获知交易的执行情况。