Status de Transação

Status possíveis de uma transação Pix. O campo status aparece nas respostas da API e nos payloads de webhook.

Status	Descrição
PENDING	Aguardando conclusão ou confirmação do pagamento
CONFIRMED	Pagamento autorizado/compensado e fundos disponíveis
FAILED	Tentativa de pagamento não concluída
REFUNDED	Valor integral devolvido ao pagador
EXPIRED	Janela de pagamento encerrada sem conclusão
DISPUTE_NEEDS_RESPONSE	Disputa aberta, ação necessária
DISPUTE_IN_REVIEW	Disputa em análise
DISPUTE_WON	Disputa resolvida a seu favor
DISPUTE_LOST	Disputa resolvida contra você

Consultar por status

Use o parâmetro status no endpoint de consulta:

GET /api/transactions — Filtrar por status

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

Veja também

• Transações — criar e consultar transações.
• Webhooks — receba mudanças de status em tempo real.