Infracoes e Defesa

Consulte infracoes (MED) associadas a sua conta e envie defesas com documentos comprobatorios.

Infracoes MED possuem prazos rigorosos definidos pelo Banco Central. O nao cumprimento dos prazos pode resultar em penalidades para a sua instituicao. Monitore regularmente e responda dentro do prazo estabelecido.

Fluxo de status: WAITING_PSP (aguardando acao) → DEFENDED (apos envio da defesa) ou CLOSED (encerrada). Acompanhe o status de cada infracao para garantir o tratamento adequado.

Documentos comprobatorios podem ser anexados como evidencia ao enviar uma defesa. Formatos aceitos incluem PDF, imagens e outros arquivos relevantes.

Listar Infracoes

GET/api/v2/infractions

Lista as infracoes associadas a conta, com filtros por data, status e paginacao.

Base URL: https://pagamentos.basspago.com.br

Headers

Header	Valor	Descricao
`Authorization`	Bearer {access_token}	Token de acesso obtido via OAuth2

Parametros de Query

Nome	Tipo	Obrigatorio	Descricao
`last_change_start`	string	Obrigatorio	Data/hora inicial do filtro (formato ISO 8601). Ex: 2026-01-01T00:00:00Z
`last_change_end`	string	Obrigatorio	Data/hora final do filtro (formato ISO 8601). Ex: 2026-01-31T23:59:59Z
`page_offset`	integer	Opcional	Numero da pagina para paginacao (minimo 1)
`page_limit`	integer	Opcional	Quantidade de registros por pagina (1-100, padrao 10)
`sort_by`	string	Opcional	Campo de ordenacao: EVENT_DATE ou STATUS
`status`	string	Opcional	Filtrar por status: ALL, ACKNOWLEDGED, WAITING_ADJUSTMENTS, DEFENDED, CLOSED

Exemplo de Response

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "type": "MED",
      "status": "WAITING_ADJUSTMENTS",
      "endToEndId": "E1234567820260101120000000000001",
      "reportedBy": "CREDITOR_PSP",
      "reportDetails": "Suspected fraud transaction",
      "transactionAmount": {
        "currency": "BRL",
        "amount": 500.00
      },
      "createdAt": "2026-01-15T10: 30:00Z",
      "lastUpdatedAt": "2026-01-16T08: 00:00Z",
      "deadline": "2026-01-22T23: 59:59Z"
    }
  ],
  "pagination": {
    "totalItems": 1,
    "totalPages": 1,
    "currentPage": 1,
    "pageSize": 10
  }
}

Exemplos de Codigo

curl -X GET \
  'https://pagamentos.basspago.com.br/api/v2/infractions?last_change_start=2026-01-01T00:00:00Z&last_change_end=2026-01-31T23:59:59Z&page_limit=10&status=WAITING_ADJUSTMENTS' \
  -H 'Authorization: Bearer {access_token}'

Detalhes da Infracao

GET/api/v2/infractions/{infractionId}

Retorna os detalhes de uma infracao especifica pelo seu identificador.

Base URL: https://pagamentos.basspago.com.br

Headers

Header	Valor	Descricao
`Authorization`	Bearer {access_token}	Token de acesso obtido via OAuth2

Parametros de Rota

Nome	Tipo	Descricao
`infractionId`	string	Identificador unico da infracao (UUID)

Exemplo de Response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "type": "MED",
  "status": "WAITING_ADJUSTMENTS",
  "endToEndId": "E1234567820260101120000000000001",
  "reportedBy": "CREDITOR_PSP",
  "reportDetails": "Suspected fraud transaction",
  "transactionAmount": {
    "currency": "BRL",
    "amount": 500.00
  },
  "debtor": {
    "name": "John Doe",
    "document": "12345678900",
    "documentType": "CPF"
  },
  "creditor": {
    "name": "Jane Smith",
    "document": "98765432100",
    "documentType": "CPF"
  },
  "createdAt": "2026-01-15T10: 30:00Z",
  "lastUpdatedAt": "2026-01-16T08: 00:00Z",
  "deadline": "2026-01-22T23: 59:59Z",
  "defenseSubmittedAt": null,
  "closedAt": null
}

Exemplos de Codigo

curl -X GET \
  https://pagamentos.basspago.com.br/api/v2/infractions/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H 'Authorization: Bearer {access_token}'

Criar Defesa

POST/api/v2/infractions/{infractionId}/defense

Envia uma defesa para uma infracao especifica, com texto de defesa e documentos comprobatorios opcionais.

Base URL: https://pagamentos.basspago.com.br

Headers

Header	Valor	Descricao
`Authorization`	Bearer {access_token}	Token de acesso obtido via OAuth2
`Content-Type`	multipart/form-data

Parametros de Rota

Nome	Tipo	Descricao
`infractionId`	string	Identificador unico da infracao (UUID)

Parametros do Body

Nome	Tipo	Obrigatorio	Descricao
`defense`	string	Obrigatorio	Texto da defesa explicando a contestacao da infracao
`files`	binary[]	Opcional	Documentos comprobatorios para anexar como evidencia (PDF, imagens, etc.)

Exemplo de Response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "DEFENDED",
  "defense": "Transaction was authorized by the account holder. Attached proof of authorization.",
  "defenseSubmittedAt": "2026-01-17T14: 30:00Z",
  "filesCount": 2
}

Exemplos de Codigo

curl -X POST \
  https://pagamentos.basspago.com.br/api/v2/infractions/a1b2c3d4-e5f6-7890-abcd-ef1234567890/defense \
  -H 'Authorization: Bearer {access_token}' \
  -F 'defense=Transaction was authorized by the account holder. Attached proof of authorization.' \
  -F 'files=@/path/to/document.pdf' \
  -F 'files=@/path/to/screenshot.png'