Listar

Requer autenticação

GET/v2/account/infractions

Lista as infrações recebidas contra transações da sua conta. Filtre por status pra priorizar as que ainda exigem resposta.

Query params

Parâmetros

pagenumber

Página (1+). Padrão: 1.

page_sizenumber

Registros por página (1–100). Padrão: 20.

statusstring

Filtrar por status: open (precisa resposta), responded (resposta enviada, em análise), resolved (concluída). Omitir = todas.

typestring

Filtrar por tipo: REFUND_REQUEST, FRAUD. Omitir = todos.

Rate limit

60 reqs/min.

Erros

Código	HTTP	Descrição
`INVALID_VALUE`	422	Valor de filtro inválido (ex: `status` ou `type` inexistente)
`UNAUTHORIZED`	401	Token inválido ou expirado

cURL

PHP

JavaScript

Python

curl -G "https://api.bspay.co/v2/account/infractions" \
  --data-urlencode "page=1" \
  --data-urlencode "page_size=20" \
  --data-urlencode "status=open" \
  -H "Authorization: Bearer SEU_TOKEN"

Resposta 200

{
  "success": true,
  "data": {
    "infractions": [
      {
        "infraction_id": "abc-uuid-1234",
        "type": "REFUND_REQUEST",
        "status": "open",
        "amount": "25.00",
        "currency": "BRL",
        "transaction_id": "tx_xyz789",
        "e2e_id": "E17028875202604301400ABC123",
        "created_at": "2026-04-30T13:00:00Z",
        "deadline_at": "2026-05-07T13:00:00Z",
        "reason": "Customer disputed — alleged unauthorized payment"
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total": 3
    }
  },
  "request_id": "39316c1fcf4333e9f4726180",
  "timestamp": "2026-04-30T13:20:30Z"
}

AnteriorVisão GeralPróximoDetalhe