Introdução

O limite Pix temporário permite que o parceiro integrador declare, para uma conta de sua titularidade, um volume adicional de Pix a ser transacionado no dia — útil para dias de pagamento em lote planejados, em que o volume a ser enviado excede o limite Pix corrente da conta.

O volume temporário corre em um contador independente do limite Pix padrão da conta. Transferências feitas pelo endpoint de transferência de Pix temporário não consomem o limite padrão, e o limite padrão permanece integralmente disponível para as transferências Pix normais.

Cada integração tem um teto diário de aprovação automática, combinado previamente com a QI Tech. Solicitações que, somadas ao que a integração já tem aprovado no dia para outras contas, cabem nesse teto são aprovadas na hora; acima dele, a aprovação é manual.

informação

A funcionalidade é habilitada sob demanda. Enquanto o limite Pix temporário não estiver habilitado para a sua integração, os endpoints desta seção respondem PXT000206.

Fluxo

O parceiro solicita um limite Pix temporário para uma conta, informando o volume total que pretende transacionar no dia (Solicitar um limite Pix temporário).
Dentro do teto de aprovação automática da integração, a solicitação é aprovada na hora e o limite já pode ser usado.
Acima do teto, a solicitação segue para análise manual da QI Tech, que pode aprová-la ou recusá-la. Enquanto pendente, ela não libera transferências; o resultado chega por webhook.
Estando a solicitação aprovada, o parceiro executa quantas transferências quiser pelo endpoint de transferência de Pix temporário, até somar o volume declarado (Realizar transferência de Pix temporário).
Enquanto nada tiver sido transferido, o parceiro pode cancelar a solicitação (Cancelar uma solicitação de limite).
Ao final do dia Pix, toda solicitação ainda em aberto é expirada automaticamente.

Janelas de horário

Os horários abaixo consideram o horário de Brasília (BRT ou UTC/GMT -03:00).

Operação	Janela
Solicitar um limite Pix temporário	06:00 às 17:00
Cancelar uma solicitação de limite	06:00 às 17:00
Realizar transferência de Pix temporário	06:00 às 20:00

cuidado

A janela de solicitação encerra às 17:00, três horas antes da janela de execução. Uma solicitação não pode ser criada nem cancelada depois das 17:00, mesmo que ainda haja volume disponível para transferir até as 20:00. Fora da janela de solicitação e cancelamento a resposta é PXT000200; depois das 20:00 a transferência responde PXT000204.

Observações

A solicitação mais recente substitui a anterior, não soma. Ao criar uma nova solicitação para a mesma conta, os volumes não se somam: vale o total_amount da mais recente que estiver aprovada. Se você já transferiu R$ 300.000,00 e passa a valer uma solicitação de R$ 500.000,00, o volume restante é R$ 200.000,00, e não R$ 500.000,00.
Uma solicitação aprovada continua utilizável enquanto um aumento aguarda análise manual. Se o novo total_amount for um aumento que ultrapassa o teto de aprovação automática da integração, a solicitação nova nasce pending_approval e a aprovada permanece aprovada — você continua transferindo dentro dela. Quando a QI Tech aprova a nova, a anterior passa a cancelled e o novo total vale; se a QI Tech recusa, a anterior segue valendo. Uma conta tem no máximo uma solicitação aprovada e no máximo uma em análise ao mesmo tempo.
Reduzir o total é imediato. Um novo total_amount menor ou igual ao aprovado é aprovado na hora e substitui o anterior, sem análise manual.
O total_amount de uma nova solicitação não pode ser inferior ao volume já transacionado no dia por Pix temporário naquela conta, justamente porque a nova solicitação substitui a anterior. Caso seja, a resposta é PXT000202.
Reduzir uma solicitação já aprovada é aprovado na hora. Se a solicitação em aberto está approved e você cria uma nova para a mesma conta com total_amount menor ou igual ao aprovado, a nova também nasce approved, ainda que o valor esteja acima do seu teto de aprovação automática — reduzir não amplia sua exposição. Aumentar o valor volta a passar pela regra normal e pode cair em análise manual, inclusive se o novo valor já tiver sido aprovado antes no mesmo dia.
O cancelamento só é possível enquanto a conta não tiver transacionado nada por Pix temporário no dia. Depois da primeira transferência a conta fica coberta por uma solicitação ativa até as 20:00, para que nunca haja volume transacionado sem solicitação que o autorize — a resposta é PXT000201.
Reuso de request_control_key é rejeitado, não reprocessado. Ao repetir uma request_control_key já utilizada na transferência de Pix temporário, a requisição é recusada; a transferência original não é retornada nem reexecutada. Envie uma chave nova para cada transferência.
Declarar muito mais do que você transaciona tem custo. Veja Subutilização — solicitações amplamente subutilizadas passam o solicitante a análise manual permanente.
Transferências de Pix temporário não consomem o limite Pix padrão da conta e não aparecem no uso reportado pela consulta de limites.
O corpo da transferência de Pix temporário aceita somente o tipo manual, com os dados da conta de destino. Transferências por chave Pix ou QR Code não são suportadas neste endpoint.

Temporary Pix Request Status

Enumerador	Descrição
approved	Solicitação aprovada e disponível para uso no dia
pending_approval	Solicitação em análise manual da QI Tech, que pode aprová-la ou recusá-la. Ainda não é utilizável
rejected	Solicitação recusada na análise manual. Estado final
cancelled	Solicitação cancelada pelo parceiro ou substituída por uma solicitação mais recente da mesma conta. Estado final
expired	Solicitação expirada no encerramento do dia Pix. Estado final

Subutilização

No encerramento do dia Pix, cada solicitação ainda aprovada é avaliada pelo volume não utilizado. Se o volume não utilizado for maior ou igual a 10% do total_amount, a QI Tech:

envia o webhook baas.pix.exceptional.underutilized; e
passa o solicitante a análise manual obrigatória para todas as solicitações futuras de limite Pix temporário.

Isto muda o tratamento das suas solicitações futuras

A análise manual obrigatória é permanente e não é revertida automaticamente. A partir dela, toda solicitação de limite Pix temporário do solicitante — inclusive as que estariam dentro do teto de aprovação automática — responde 202 com pending_approval e depende de aprovação manual da QI Tech antes de ser utilizável. Declare um total_amount próximo do volume que você efetivamente pretende transacionar.

Webhooks

Os três eventos abaixo são enviados ao solicitante. O corpo é o mesmo objeto retornado pela consulta de solicitações de limite, com os campos adicionais indicados.

Evento	Quando é enviado
`baas.pix.exceptional.approved`	Uma solicitação em análise manual foi aprovada e já pode ser utilizada
`baas.pix.exceptional.rejected`	Uma solicitação em análise manual foi recusada. Traz `rejected_reason` se informado
`baas.pix.exceptional.underutilized`	Uma solicitação aprovada foi amplamente subutilizada no encerramento do dia Pix

informação

A aprovação automática — a solicitação que já nasce approved dentro do teto — não gera webhook: o 201 da própria criação já informa o resultado.

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

Campo	Tipo	Descrição
`pix_request_key`	uuidv4	Chave única de identificação da solicitação de limite Pix temporário.
`account_key`	uuidv4	Conta à qual a solicitação se aplica.
`total_amount`	number	Volume total declarado para o dia.
`status`	enumerator	Status da solicitação. Ver Temporary Pix Request Status.
`message`	string	Texto descritivo do status, em inglês.
`rejected_reason`	string	Motivo da recusa, quando informado. Opcional — pode não vir mesmo em uma recusa.
`used_amount`	number	Volume efetivamente transacionado. Presente apenas no evento de subutilização.
`unused_amount`	number	Volume declarado e não transacionado. Presente apenas no evento de subutilização.
`max_unused_amount`	number	Volume não utilizado a partir do qual a subutilização é caracterizada. Apenas na subutilização.
`requires_manual_approval`	boolean	Indica que as solicitações futuras do solicitante passam a exigir análise manual. Apenas na subutilização.

Fluxo​

Janelas de horário​

Observações​

Temporary Pix Request Status​

Subutilização​

Webhooks​

Webhook Body Params​