Fila de Saída

O que é a Fila de Saída?

A Fila de Saída representa o estágio onde ficam registradas todas as transações de débito (cash-out) antes da liquidação final.

Fluxo padrão da transação

Quando não há intercorrências, a transação segue o seguinte fluxo:

Fila de Saída → Core → SPI

Quando uma transação permanece na fila?

Uma transação pode permanecer na fila de saída nos seguintes cenários:

1. Baixa disponibilidade de fichas

Quando não há fichas suficientes disponíveis para validação da chave do recebedor.

2. Rate limit ativo

Se todas as fichas do balde forem consumidas:

O sistema entra em rate limit

Novas validações ficam temporariamente bloqueadas

As fichas são reabastecidas de forma progressiva

Durante esse período, podem ocorrer:
atrasos
oscilações nas respostas

3. Análise antifraude

Se o sistema antifraude identificar risco no CPF envolvido:

A transação pode ser interrompida

O webhook retornará:

{
  "message": "Transação não autorizada"
}

Fichas

As fichas representam a capacidade de validação de dados no BACEN.

Funcionamento

Cada transação de cash-out consome 1 ficha

A ficha é utilizada para:

validar dados do recebedor

validar chave Pix

Balde

O balde é o repositório onde ficam armazenadas as fichas disponíveis.

Características

Cada cliente possui seu próprio balde

O controle é feito por instituição financeira

Exemplo

CPF: 999.999.999-99

Instituição A → 100 fichas  
Instituição B → 100 fichas

Resumo

Fila de saída é a etapa inicial do cash-out

Transações podem ficar retidas por:

falta de fichas

rate limit

antifraude

Fichas são consumidas a cada validação no BACEN

O balde controla a disponibilidade de fichas por instituição

O que é a Fila de Saída?#

Fluxo padrão da transação#

Quando uma transação permanece na fila?#

1. Baixa disponibilidade de fichas#

2. Rate limit ativo#

3. Análise antifraude#

Fichas#

Funcionamento#

Balde#

Características#

Exemplo#

Resumo#