Status de transação

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

Status	Significado
PENDING	Cobrança criada, aguardando o pagamento
CONFIRMED	Pagamento compensado e valor creditado
FAILED	Tentativa de pagamento não concluída
EXPIRED	Prazo encerrado sem pagamento
REFUNDED	Valor integral devolvido ao pagador
DISPUTE_NEEDS_RESPONSE	Disputa aberta — precisa da sua resposta
DISPUTE_IN_REVIEW	Disputa em análise
DISPUTE_WON	Disputa resolvida a seu favor
DISPUTE_LOST	Disputa resolvida contra você

Transições permitidas

A máquina de status é fechada: só as transições abaixo acontecem.

De	Para
`PENDING`	`CONFIRMED`, `FAILED`, `EXPIRED`
`CONFIRMED`	`REFUNDED`, `DISPUTE_NEEDS_RESPONSE`
`DISPUTE_NEEDS_RESPONSE`	`DISPUTE_IN_REVIEW`, `DISPUTE_WON`, `DISPUTE_LOST`
`DISPUTE_IN_REVIEW`	`DISPUTE_WON`, `DISPUTE_LOST`
`FAILED`, `EXPIRED`, `REFUNDED`, `DISPUTE_WON`, `DISPUTE_LOST`	(terminal)

Consultar por status

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

Um status que não existe é recusado com 400 — o filtro é validado antes da consulta.

Veja também

Cobranças — criar e consultar.
Receber webhooks — as transições em tempo real.
Ambiente sandbox — provoque cada status de propósito.