PayZuPayZu Docs
Endpoints da APIInfrações (MED)

Listar infrações

GET
/user/infractions

Authorization

BearerAuth
AuthorizationBearer <token>

In: header

Query Parameters

page?integer
Default1
Range1 <= value
limit?integer
Default10
Range1 <= value <= 100
status?string

InfractionStatus separados por vírgula (WAITING_PSP,CLOSED,OPEN,CANCELLED,ACKNOWLEDGED,DEFENDED,ANSWERED,WAITING_ADJUSTMENTS)

type?string

InfractionType separados por vírgula (REFUND_REQUEST,FRAUD,REFUND_CANCELLED)

endToEndId?string
transactionId?string
amountMin?number
amountMax?number
analysisResult?string

AnalysisResult separados por vírgula

reportedBy?string

ReportedType separados por vírgula (DEBITED_PARTICIPANT,CREDITED_PARTICIPANT)

participantDocument?string
participantName?string
sortBy?string

Campo de ordenação.

sortDirection?string

Direção da ordenação.

Value in"asc" | "desc"
reportedAtFrom?string

Filtro: reportedAt a partir de.

Formatdate-time
reportedAtTo?string

Filtro: reportedAt até.

Formatdate-time
createdAtFrom?string

Filtro: createdAt a partir de.

Formatdate-time
createdAtTo?string

Filtro: createdAt até.

Formatdate-time
expiresAtFrom?string

Filtro: expiresAt a partir de.

Formatdate-time
expiresAtTo?string

Filtro: expiresAt até.

Formatdate-time
updatedAtFrom?string

Filtro: updatedAt a partir de.

Formatdate-time
updatedAtTo?string

Filtro: updatedAt até.

Formatdate-time
needsManualReview?boolean

Filtro: precisa de revisão manual.

id?string

Filtro por ID da infração.

protocol?string

Filtro por protocolo.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://api.payzu.processamento.com/v1/user/infractions"
{
  "infractions": [
    {
      "id": "infraction_id",
      "protocol": "PROTOCOL123",
      "status": "OPEN",
      "type": "FRAUD",
      "reportedBy": "DEBITED_PARTICIPANT",
      "reportDetails": "Transação não autorizada",
      "analysisResult": null,
      "analysisDetails": null,
      "reportedAt": "2024-01-15T10:30:00Z",
      "expiresAt": "2024-02-15T10:30:00Z",
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z",
      "transaction": {
        "id": "transaction_id",
        "amount": 100.5,
        "payerName": "João Silva",
        "payerDocument": "12345678901",
        "receiverName": "Maria Santos",
        "receiverDocument": "12345678901",
        "endToEndId": "E12345678202401151030001"
      },
      "defenseHistory": []
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "totalItems": 45,
    "totalPages": 3
  }
}
{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "querystring/dateFrom Invalid input: expected string, received undefined",
  "requestId": "cmou00000abcdef01s6ghij1k2lm"
}
{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Missing or invalid Bearer token",
  "requestId": "cmou00000abcdef01s6ghij1k2lm"
}
{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Resource not found",
  "requestId": "cmou00000abcdef01s6ghij1k2lm"
}

Infrações (MED)

Endpoints para lidar com disputas Pix abertas via Mecanismo Especial de Devolução (MED) do Bacen. Listar infrações, ver detalhe, submeter defesa e acompanhar histórico de defesas.

Detalhe da infração

Retorna o detalhe completo de uma infração: motivo, valor contestado, prazo de defesa e transação relacionada.