Status de saque

O campo status aparece nas respostas da API e nos payloads de webhook.

Status	Significado
CREATED	Solicitação aceita e valor reservado
PROCESSING	Transferência em execução no adquirente
CONFIRMED	Transferência concluída
FAILED	Transferência não concluída — o valor volta ao saldo
CANCELED	Cancelada antes da conclusão
REFUNDED	Devolvida depois de concluída

Transições permitidas

De	Para
CREATED	PROCESSING, CONFIRMED, CANCELED, FAILED
PROCESSING	CONFIRMED, FAILED, CANCELED
CONFIRMED	REFUNDED
FAILED, CANCELED, REFUNDED	(terminal)

O saldo acompanha o status

Ao criar o saque, o valor sai de balance e vai para processing — ainda é seu, mas já não pode ser gasto de novo. Em CONFIRMED ele sai de vez; em FAILED ou CANCELED volta para balance.

Cancelamento

Um saque em CREATED pode ter o cancelamento solicitado pelo painel. A solicitação apenas sinaliza o pedido: quem cancela de fato é o operador, porque a transferência pode já estar a caminho do banco de destino.

Consultar por status

GET /api/withdrawals — filtrar por status

curl --request GET \
  --url 'https://api.avexus.app/api/withdrawals?status=CREATED&limit=20' \
  --header 'x-api-key: <API_KEY>' \
  --header 'x-token: <TOKEN>' \
  --header 'x-timezone: America/Sao_Paulo'

Veja também

• Saques — solicitar e consultar.
• Receber webhooks — as transições em tempo real.
• Saldo e extrato — de onde sai e para onde volta o valor.