简介

临时 Pix 限额允许集成合作伙伴为其自有账户申报当日额外的 Pix 交易额度 —— 适用于已计划的批量付款日，即当日需要发送的金额超过该账户当前 Pix 限额的情况。

临时额度使用独立于账户标准 Pix 限额的计数器。通过临时 Pix 转账接口发起的转账不消耗标准限额，标准限额仍然完整地保留给普通 Pix 转账使用。

每家集成都有一个与 QI Tech 事先约定的每日自动审批上限。若申请额度加上该集成当日已为其他账户获批的额度仍在上限之内，申请即时获批；超出上限则需人工审批。

信息

该功能按需启用。在您的集成尚未启用临时 Pix 限额之前，本节的接口均返回 PXT000206。

流程

合作伙伴为某个账户申请临时 Pix 限额，申报当日计划交易的总额度（申请临时 Pix 限额）。
在集成的自动审批上限之内，申请即时获批，限额可立即使用。
超出上限时，申请转入 QI Tech 人工审核，可能获批或被拒。审核期间不可发起转账；结果通过 Webhook 通知。
申请获批后，合作伙伴可通过临时 Pix 转账接口发起任意笔数的转账，直至累计达到申报额度（发起临时 Pix 转账）。
只要尚未发生任何转账，合作伙伴可以取消该申请（取消限额申请）。
在 Pix 日结束时，所有仍处于开放状态的申请将自动过期。

时间窗口

以下时间均为巴西利亚时间（BRT，即 UTC/GMT -03:00）。

操作	时间窗口
申请临时 Pix 限额	06:00 至 17:00
取消限额申请	06:00 至 17:00
发起临时 Pix 转账	06:00 至 20:00

警告

申请窗口在 17:00 关闭，比执行窗口早三个小时。17:00 之后既不能创建也不能取消申请，即使仍有额度可在 20:00 之前转出。在申请与取消窗口之外，响应为 PXT000200；20:00 之后，转账响应为 PXT000204。

注意事项

最新的申请会替换先前的申请，而不是累加。 为同一账户创建新申请时，额度不会累加：以最新的已获批申请的 total_amount 为准。若您已转出 R$ 300.000,00，且生效额度为 R$ 500.000,00，则剩余额度为 R$ 200.000,00，而不是 R$ 500.000,00。
在增额申请等待人工审核期间，已获批的申请仍然可用。 若新的 total_amount 是超出该集成自动审批上限的增额，新申请将处于 pending_approval，而已获批的申请保持 approved —— 您可继续在其额度内转账。QI Tech 批准新申请后，先前的申请变为 cancelled，并以新额度为准；若被拒绝，先前的申请继续有效。每个账户同时最多有一个已获批申请和一个待审核申请。
降低额度即时生效。 新的 total_amount 小于或等于已获批额度时，将即时获批并替换先前的申请，无需人工审核。
新申请的 total_amount 不得低于该账户当日已通过临时 Pix 转出的金额，正因为新申请会替换先前的申请。若低于该金额，响应为 PXT000202。
调低已获批申请的额度会即时获批。 若开放中的申请处于 approved，而您为同一账户创建的新申请其 total_amount 小于或等于已获批的额度，则新申请同样直接为 approved，即使该金额高于您的自动审批上限 —— 因为调低不会扩大您的风险敞口。调高额度则重新适用常规规则，可能转入人工审核，即便该金额当日早前已被批准过。
只有在该账户当日尚未通过临时 Pix 转出任何金额时才能取消。 首次转账之后，该账户将由一个有效申请覆盖直至 20:00，以确保已转出的金额始终有申请为其授权 —— 响应为 PXT000201。
重复使用 request_control_key 会被拒绝，而不是重放。 在临时 Pix 转账中重复使用已用过的 request_control_key 时，请求将被拒绝；原转账不会被返回，也不会被重新执行。请为每笔转账使用新的 key。
申报额度远高于实际交易额是有代价的。 参见额度使用不足 —— 额度使用严重不足的申请会使该请求方永久转入人工审核。
临时 Pix 转账不消耗账户的标准 Pix 限额，也不会出现在限额查询所报告的使用量中。
临时 Pix 转账的请求体仅接受 manual 类型，并需提供目标账户数据。本接口不支持通过 Pix 键或 QR 码转账。

Temporary Pix Request Status

枚举值	描述
approved	申请已获批，当日可用
pending_approval	申请正在 QI Tech 人工审核中，可能获批或被拒。尚不可用
rejected	申请在人工审核中被拒绝。终态
cancelled	申请被合作伙伴取消，或被同一账户更新的申请替换。终态
expired	申请在 Pix 日结束时过期。终态

额度使用不足

在 Pix 日结束时，系统会对每个仍处于 approved 状态的申请按未使用额度进行评估。若未使用额度大于或等于 total_amount 的 10%，QI Tech 将：

发送 baas.pix.exceptional.underutilized Webhook；并且
将该请求方的所有后续临时 Pix 限额申请转为强制人工审核。

这会改变您后续申请的处理方式

强制人工审核是永久性的，不会自动撤销。自此之后，该请求方的每一个临时 Pix 限额申请 —— 包括本应在自动审批上限之内的申请 —— 都将返回 202 与 pending_approval，且必须经 QI Tech 人工批准后才可使用。请申报接近您实际计划交易金额的 total_amount。

Webhooks

以下三个事件会发送给请求方。请求体与限额申请查询返回的对象相同，并附加所标注的字段。

事件	发送时机
`baas.pix.exceptional.approved`	人工审核中的申请已获批，可立即使用
`baas.pix.exceptional.rejected`	人工审核中的申请被拒绝。若已填写，会附带 `rejected_reason`
`baas.pix.exceptional.underutilized`	已获批的申请在 Pix 日结束时被判定额度使用严重不足

信息

自动批准 —— 即在自动审批上限之内直接以 approved 创建的申请 —— 不会产生 Webhook：创建本身返回的 201 已经告知了结果。

Webhook Body: baas.pix.exceptional.approved

{
  "pix_request_key": "9c3b7d21-8f4a-4c2b-9e1d-7a6b5c4d3e2f",
  "account_key": "0f2a1e4c-1111-2222-3333-444455556666",
  "total_amount": 1200000.00,
  "status": "approved",
  "message": "Request approved and available for use today until 20:00."
}

Webhook Body: baas.pix.exceptional.rejected

{
  "pix_request_key": "9c3b7d21-8f4a-4c2b-9e1d-7a6b5c4d3e2f",
  "account_key": "0f2a1e4c-1111-2222-3333-444455556666",
  "total_amount": 1200000.00,
  "status": "rejected",
  "message": "Request rejected after manual analysis.",
  "rejected_reason": "Volume incompatível com o histórico da conta"
}

Webhook Body: baas.pix.exceptional.underutilized

{
  "pix_request_key": "9c3b7d21-8f4a-4c2b-9e1d-7a6b5c4d3e2f",
  "account_key": "0f2a1e4c-1111-2222-3333-444455556666",
  "total_amount": 1200000.00,
  "status": "expired",
  "message": "Request expired and no longer available for use.",
  "used_amount": 150000.00,
  "unused_amount": 1050000.00,
  "max_unused_amount": 240000.00,
  "requires_manual_approval": true
}

Webhook Body Params

字段	类型	描述
`pix_request_key`	uuidv4	临时 Pix 限额申请的唯一标识键。
`account_key`	uuidv4	该申请所适用的账户。
`total_amount`	number	当日申报的总额度。
`status`	enumerator	申请状态。参见 Temporary Pix Request Status。
`message`	string	状态的描述文本，为英文。
`rejected_reason`	string	拒绝原因，若已填写。可选 —— 即使申请被拒绝也可能不返回该字段。
`used_amount`	number	实际交易金额。仅在额度使用不足事件中出现。
`unused_amount`	number	已申报但未交易的金额。仅在额度使用不足事件中出现。
`max_unused_amount`	number	判定为额度使用不足的未使用金额门槛。仅在额度使用不足事件中出现。
`requires_manual_approval`	boolean	表示该请求方的后续申请将需要人工审核。仅在额度使用不足事件中出现。

流程​

时间窗口​

注意事项​

Temporary Pix Request Status​

额度使用不足​

Webhooks​

Webhook Body Params​

流程