跳到主要内容

简介

通过本节介绍的接口,集成合作伙伴可以申请 Pix 类型的交易预约。利用此功能,可以针对特定账户创建、列出和取消预约。

注意事项

  • 预约日期以巴西利亚时间(BRT 或 UTC/GMT -03:00)为准
  • 交易将从 BRT 时间 8 点开始尝试执行
  • 因余额不足而失败的交易将每隔 1 小时重试,最多重试 3 次
  • 对于 keystatic_qr_codedynamic_qr_code 类型的交易,在交易完成之前,将对 Pix 密钥进行新的核实,以确保目标账户未被更改。如果发现任何差异,预约将被拒绝(rejected
  • 集成合作伙伴将收到一个 webhook,通知预约的成功或拒绝
  • 无法预约即时 dynamic_qr_code
  • 预约转账会消耗 Pix 交易限额

Pix Schedule Status

枚举值描述
scheduled交易已预约
sent预约完成并成功发送。最终状态
rejected预约在创建或执行期间被拒绝。最终状态
cancelled应客户申请取消预约。最终状态
pending_2fa_approval待双因素认证批准
pending_creation预约正在创建(批量预约的过渡状态)
waiting_batch_approval预约已创建并关联到批次,等待双因素认证批准

Schedule Transfers

在预约当天,对目标账户进行一致性验证后,将尝试执行 Pix 交易。此时会生成一个 pix_transfer,并将其添加到 schedule_transfers 列表中。最多尝试 3 次 Pix 交易。

Schedule Transfer Object

字段类型描述字符数
pix_transfer_keyuuidv4QI 系统中 Pix 转账的唯一标识键。36
end_to_end_id *stringSPI(即时支付系统)内 Pix 交易的幂等键32
pix_transfer_statusstring交易状态。Enumeradores pix_transfer_status
created_atstring交易创建日期和时间。20

Enumerador Pix Transfer Status

枚举值描述
sent交易成功发送。最终状态
rejected交易在执行期间被拒绝。最终状态
pending交易待完成。过渡状态