跳到主要内容

PIX QR 码简介

间接参与者的任何客户(Alias)都可以执行 PIX QR 码的创建、查询和撤销操作。

  • 创建:可以生成静态或动态类型的 QR 码。对于动态类型,可以生成即时支付动态码或长期到期动态码。各类型将在创建流程中详细说明。

  • 查询:拥有 QR 码或其 URL(PIX 复制粘贴格式),即可查询其信息以便后续支付。查询过程称为 QR 码解码,并生成一个用于后续支付的 end_to_end_id

  • 撤销:撤销 QR 码将使其无效,无法再用于支付。主要撤销原因包括:到期、Alias 主动取消,或已完成支付。

QR 码类型

QR 码类型在创建时通过 qr_code_type 字段定义。

名称枚举值描述
静态static包含目标 PIX 密钥,可选填金额。只要密钥处于活跃状态,随时可以支付。无有效期限制,可重复使用。
即时支付动态码dynamic_instant包含支付信息,含已定义付款方、金额和对账密钥。支付期限以秒计。仅限一次性使用。
有效期动态码dynamic_term包含支付信息,含已定义付款方、金额和对账密钥。支付期限以天计,含罚款和利息信息。仅限一次性使用。

支付 QR 码

解码 QR 码和查询密钥后,将生成 end_to_end_id,用于支付指令以完成交易。此外,对于动态 QR 码,receiver_conciliation_id 字段用于识别正在支付的具体 QR 码,收款方在支付后用其推进操作流程。

解码 QR 码后,应发送带有 end_to_end_idreceiver_conciliation_id 的 PIX 支付指令,接收方银行即可继续处理。同样,当收到 static_qr_codedynamic_qr_code 类型的 PIX 支付时,将发送一个 webhook,本 QR 码章节末尾也有相关说明。