Pular para o conteúdo principal

Consultar o uso do limite Pix temporário

Retorna o volume que a conta já transacionou no dia Pix corrente pela trilha temporária — o quanto do limite já foi consumido. É o valor que decide se um cancelamento será aceito e quanto ainda resta do limite aprovado.

Request

ENDPOINT
/baas/pix/limits/ACCOUNT_KEY/exceptional_usage
MÉTODO
GET

Não há restrição de horário nesta operação.

Path Params

CampoTipoDescriçãoCaracteres
account_keyuuidv4Chave única de identificação da conta, de titularidade do solicitante.36

Response

Response Body: 200 OK
{
"exceptional_pix_amount_used": 300000.00
}

Response Body Params

CampoTipoDescrição
exceptional_pix_amount_usednumberVolume já transacionado pela conta no dia Pix corrente pela trilha temporária.
Para que serve
  • Saber se o cancelamento vai passar. A solicitação approved só pode ser cancelada enquanto este valor é 0. Veja Cancelar uma solicitação de limite.
  • Saber quanto resta. O volume restante é o total_amount da solicitação aprovada menos este valor.
  • Saber o piso da próxima solicitação. Um novo total_amount não pode ser inferior a este valor, sob pena de PXT000202.
cuidado

O contador é por conta e por dia Pix (das 06:00 às 06:00 do dia seguinte), não por solicitação. Volume transacionado sob uma solicitação que depois foi substituída continua contando no dia. Uma transferência que terminou recusada não conta.