跳到主要内容

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 转账的端到端标识符,用于控制巴西中央银行的速率限制。

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

    交易同步性

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

    信息

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

    信息

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

    交易重试

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

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