通过本节介绍的接口,集成合作伙伴可以申请 Pix 类型的交易预约。利用此功能,可以针对特定账户创建、列出和取消预约。
- 预约日期以巴西利亚时间(BRT 或 UTC/GMT -03:00)为准
- 交易将从 BRT 时间 8 点开始尝试执行
- 因余额不足而失败的交易将每隔 1 小时重试,最多重试 3 次
- 对于 key、static_qr_code 和 dynamic_qr_code 类型的交易,在交易完成之前,将对 Pix 密钥进行新的核实,以确保目标账户未被更改。如果发现任何差异,预约将被拒绝(rejected)
- 集成合作伙伴将收到一个 webhook,通知预约的成功或拒绝
- 无法预约即时 dynamic_qr_code
- 预约转账会消耗 Pix 交易限额
| 枚举值 | 描述 |
|---|
| scheduled | 交易已预约 |
| sent | 预约完成并成功发送。最终状态 |
| rejected | 预约在创建或执行期间被拒绝。最终状态 |
| cancelled | 应客户申请取消预约。最终状态 |
| pending_2fa_approval | 待双因素认证批准 |
| pending_creation | 预约正在创建(批量预约的过渡状态) |
| waiting_batch_approval | 预约已创建并关联到批次,等待双因素认证批准 |
在预约当天,对目标账户进行一致性验证后,将尝试执行 Pix 交易。此时会生成一个 pix_transfer,并将其添加到 schedule_transfers 列表中。最多尝试 3 次 Pix 交易。
| 字段 | 类型 | 描述 | 字符数 |
|---|
pix_transfer_key | uuidv4 | QI 系统中 Pix 转账的唯一标识键。 | 36 |
end_to_end_id * | string | SPI(即时支付系统)内 Pix 交易的幂等键 | 32 |
pix_transfer_status | string | 交易状态。 | Enumeradores pix_transfer_status |
created_at | string | 交易创建日期和时间。 | 20 |
| 枚举值 | 描述 |
|---|
| sent | 交易成功发送。最终状态 |
| rejected | 交易在执行期间被拒绝。最终状态 |
| pending | 交易待完成。过渡状态 |