Listar Infrações Com paginacao

Importante:

Para usar esta API, é necessário estar autenticado e incluir seu token de autenticação no cabeçalho da requisição. Consulte a documentação de Autenticação na plataforma para mais informações.

Autenticação.

O Sistema Cliente deve consumir essa API sempre que precisar obter informações sobre as Notificações de Infração, tanto aquelas relatadas pelo PSP quanto as recebidas de outros PSPs. O Regulamento do Pix estabelece prazos para os PSPs envolvidos se pronunciarem sobre uma Notificação de Infração.

Como utilizar?

Para utilizar essa funcionalidade, siga estes passos simples. Abaixo, você encontrará exemplos de como realizar o processo receber as infracoes pendentes dos clientes indiretos.

Requisição de exemplo

Listar Infrações

get

Endpoint para listar infrações pendentes com paginação e filtros opcionais.

Authorizations

Query parameters

pageintegerOptional

Número da página para paginação.

Default: 1Example: 1

limitintegerOptional

Limite de infrações por página.

Default: 10Example: 10

valorDevolucaostringOptional

Valor da devolução associada à infração.

Example: 1500.00

stRelatoInfracaostring · enumOptional

Tipo de infração para filtro. Valores possíveis:

• 0: Aberta!
• 1: Recebida!
• 2: Cancelada!
• 3: Analisada!
• 4: Banco analisando resposta do cliente!

Example: 3Possible values:

resultadoAnalisestring · enumOptional

Resultado da analise da infração. Valores possíveis:

• 0: Aceita!
• 1: Rejeitada!
• 2: Rejeitada pelo Cliente (Esperando banco analisar resposta)!

Example: 2Possible values:

startDatestring · dateOptional

Data de início para filtrar infrações por período.

Example: 2023-01-01

endDatestring · dateOptional

Data de término para filtrar infrações por período.

Example: 2023-12-31

endToEndIdDevolucaostringOptional

Identificador end-to-end da transação de devolução para a infração.

Example: D99999010111241234123412345678900

endToEndOriginstringOptional

Identificador end-to-end da transação que sofreu infração.

Example: E99999010111241234123412345678900

idRelatoInfracaostringOptional

ID do relato de infração específico.

Example: 708df85a-3521-4d93-90ca-7e51a869586e

Responses

200

Requisição bem-sucedida

application/json

401

Falha de autorização.

422

Falha de validação.

500

Erro desconhecido no servidor.

get

HTTPcURLJavaScriptPython

GET /internal/api/v1/violations/findall HTTP/1.1
Host: sandbox.globalscm.app.br
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "dthr": "2024-11-01T13:03:04.769Z",
  "totalViolations": 678,
  "page": 2,
  "limitPage": 100,
  "hasBeforePage": true,
  "hasAfterPage": true,
  "violations": [
    {
      "endToEndId": "E0011000020241014154333B09Y5iKL4xx",
      "reason": "SOLICITACAO_DEVOLUCAO",
      "statusOriginType": "GOLPE_ESTELEIONATO",
      "details": "Transação contestada formalmente como fraude.",
      "violationId": "2c3eeZbb-xxxx-X37e-b6U0-22e1d262babb",
      "statusReportViolation": "ANALISANDO",
      "resultAnalyzeReportViolation": "null",
      "pspCreator": 60746948,
      "pspParty": 11165756,
      "dtHrCreatedReportViolation": "2024-10-22T02:48:51.586Z",
      "dtHrModify": "2024-10-25T13:58:03.807Z"
    }
  ]
}

JSON Retorno Sucesso