Consultar infração

curl -X GET "https://pagamentos.basspago.com.br/api/v2/infractions/b2d4f6a8-1357-4ace-9bdf-024681357900" \
  --cert ./client.crt \
  --key ./client.key \
  --pass "SUA_SENHA_DO_CERTIFICADO" \
  -H "Authorization: Bearer {access_token}"

<?php

$infractionId = 'b2d4f6a8-1357-4ace-9bdf-024681357900';
$ch = curl_init("https://pagamentos.basspago.com.br/api/v2/infractions/{$infractionId}");

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_SSLCERT => './client.crt',
    CURLOPT_SSLKEY => './client.key',
    CURLOPT_KEYPASSWD => 'SUA_SENHA_DO_CERTIFICADO',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer {access_token}'],
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

import fs from "node:fs";
import https from "node:https";
import axios from "axios";

const agent = new https.Agent({
  cert: fs.readFileSync("./client.crt"),
  key: fs.readFileSync("./client.key"),
  passphrase: "SUA_SENHA_DO_CERTIFICADO",
});

const infractionId = "b2d4f6a8-1357-4ace-9bdf-024681357900";

const { data } = await axios.get(
  `https://pagamentos.basspago.com.br/api/v2/infractions/${infractionId}`,
  {
    httpsAgent: agent,
    headers: { Authorization: "Bearer {access_token}" },
  }
);

console.log(data);

{
  "id": "b2d4f6a8-1357-4ace-9bdf-024681357900",
  "type": "MED",
  "status": "WAITING_ADJUSTMENTS",
  "endToEndId": "E87654321202607211856a1b2c3d4e5f",
  "reportedBy": "CREDITOR_PSP",
  "reportDetails": "Cliente contestou o pagamento por suspeita de fraude",
  "transactionAmount": {
    "currency": "BRL",
    "amount": 49.90
  },
  "debtor": {
    "name": "Carlos Henrique Souza",
    "document": "11144477735",
    "documentType": "CPF"
  },
  "creditor": {
    "name": "Sua Loja Ltda",
    "document": "12345678000199",
    "documentType": "CNPJ"
  },
  "createdAt": "2026-07-21T10:30:00Z",
  "lastUpdatedAt": "2026-07-21T18:56:00Z",
  "deadline": "2026-07-22T23:59:59Z",
  "defenseSubmittedAt": null,
  "closedAt": null
}

GET

api

infractions

{infractionId}

curl -X GET "https://pagamentos.basspago.com.br/api/v2/infractions/b2d4f6a8-1357-4ace-9bdf-024681357900" \
  --cert ./client.crt \
  --key ./client.key \
  --pass "SUA_SENHA_DO_CERTIFICADO" \
  -H "Authorization: Bearer {access_token}"

<?php

$infractionId = 'b2d4f6a8-1357-4ace-9bdf-024681357900';
$ch = curl_init("https://pagamentos.basspago.com.br/api/v2/infractions/{$infractionId}");

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_SSLCERT => './client.crt',
    CURLOPT_SSLKEY => './client.key',
    CURLOPT_KEYPASSWD => 'SUA_SENHA_DO_CERTIFICADO',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer {access_token}'],
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

import fs from "node:fs";
import https from "node:https";
import axios from "axios";

const agent = new https.Agent({
  cert: fs.readFileSync("./client.crt"),
  key: fs.readFileSync("./client.key"),
  passphrase: "SUA_SENHA_DO_CERTIFICADO",
});

const infractionId = "b2d4f6a8-1357-4ace-9bdf-024681357900";

const { data } = await axios.get(
  `https://pagamentos.basspago.com.br/api/v2/infractions/${infractionId}`,
  {
    httpsAgent: agent,
    headers: { Authorization: "Bearer {access_token}" },
  }
);

console.log(data);

{
  "id": "b2d4f6a8-1357-4ace-9bdf-024681357900",
  "type": "MED",
  "status": "WAITING_ADJUSTMENTS",
  "endToEndId": "E87654321202607211856a1b2c3d4e5f",
  "reportedBy": "CREDITOR_PSP",
  "reportDetails": "Cliente contestou o pagamento por suspeita de fraude",
  "transactionAmount": {
    "currency": "BRL",
    "amount": 49.90
  },
  "debtor": {
    "name": "Carlos Henrique Souza",
    "document": "11144477735",
    "documentType": "CPF"
  },
  "creditor": {
    "name": "Sua Loja Ltda",
    "document": "12345678000199",
    "documentType": "CNPJ"
  },
  "createdAt": "2026-07-21T10:30:00Z",
  "lastUpdatedAt": "2026-07-21T18:56:00Z",
  "deadline": "2026-07-22T23:59:59Z",
  "defenseSubmittedAt": null,
  "closedAt": null
}

Essa rota utiliza os certificados e o Bearer Token de Cash Out.

Todo MED exige resposta em até 24 horas quando o status for WAITING_ADJUSTMENTS (ou equivalente aguardando resposta). Trate esses eventos com prioridade.

Fluxo de status: WAITING_PSP (aguardando sua ação) → DEFENDED (depois que você envia a defesa) ou CLOSED (contestação encerrada). Acompanhe cada contestação para não perder o prazo de resposta.

Certificados

Esta rota usa autenticação mútua (mTLS). Envie o certificado de Cash Out, a chave e a senha na requisição:

--cert

file

required

Certificado de Cash Out do cliente (client.crt).

--key

file

required

Chave privada do cliente (client.key).

--pass

string

required

Senha para descriptografar a chave .key, enviada por e-mail junto com os certificados.

Headers

Authorization

string

required

Bearer Token de Cash Out. Formato: Bearer {access_token}.

Path

infractionId

string

required

Identificador da contestação (MED) que você quer consultar.

Resposta

string

Identificador da contestação (MED).

type

string

Tipo da contestação (ex.: MED).

status

string

Status atual da contestação.

endToEndId

string

Identificador end-to-end do Pix contestado.

reportedBy

string

Quem abriu a contestação.

reportDetails

string

Motivo informado na abertura da contestação.

transactionAmount

object

Valor da transação contestada (currency, amount).

debtor

object

Dados da parte pagadora (name, document, documentType).

creditor

object

Dados da parte recebedora (name, document, documentType).

createdAt

string

Data e hora de abertura (ISO 8601).

lastUpdatedAt

string

Data e hora da última atualização (ISO 8601).

deadline

string

Prazo limite para resposta (ISO 8601).

defenseSubmittedAt

string

Data e hora do envio da defesa. null se ainda não houver defesa.

closedAt

string

Data e hora do encerramento. null se a contestação ainda estiver aberta.

curl -X GET "https://pagamentos.basspago.com.br/api/v2/infractions/b2d4f6a8-1357-4ace-9bdf-024681357900" \
  --cert ./client.crt \
  --key ./client.key \
  --pass "SUA_SENHA_DO_CERTIFICADO" \
  -H "Authorization: Bearer {access_token}"

<?php

$infractionId = 'b2d4f6a8-1357-4ace-9bdf-024681357900';
$ch = curl_init("https://pagamentos.basspago.com.br/api/v2/infractions/{$infractionId}");

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_SSLCERT => './client.crt',
    CURLOPT_SSLKEY => './client.key',
    CURLOPT_KEYPASSWD => 'SUA_SENHA_DO_CERTIFICADO',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer {access_token}'],
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

import fs from "node:fs";
import https from "node:https";
import axios from "axios";

const agent = new https.Agent({
  cert: fs.readFileSync("./client.crt"),
  key: fs.readFileSync("./client.key"),
  passphrase: "SUA_SENHA_DO_CERTIFICADO",
});

const infractionId = "b2d4f6a8-1357-4ace-9bdf-024681357900";

const { data } = await axios.get(
  `https://pagamentos.basspago.com.br/api/v2/infractions/${infractionId}`,
  {
    httpsAgent: agent,
    headers: { Authorization: "Bearer {access_token}" },
  }
);

console.log(data);

{
  "id": "b2d4f6a8-1357-4ace-9bdf-024681357900",
  "type": "MED",
  "status": "WAITING_ADJUSTMENTS",
  "endToEndId": "E87654321202607211856a1b2c3d4e5f",
  "reportedBy": "CREDITOR_PSP",
  "reportDetails": "Cliente contestou o pagamento por suspeita de fraude",
  "transactionAmount": {
    "currency": "BRL",
    "amount": 49.90
  },
  "debtor": {
    "name": "Carlos Henrique Souza",
    "document": "11144477735",
    "documentType": "CPF"
  },
  "creditor": {
    "name": "Sua Loja Ltda",
    "document": "12345678000199",
    "documentType": "CNPJ"
  },
  "createdAt": "2026-07-21T10:30:00Z",
  "lastUpdatedAt": "2026-07-21T18:56:00Z",
  "deadline": "2026-07-22T23:59:59Z",
  "defenseSubmittedAt": null,
  "closedAt": null
}

Listar contestações Enviar defesa

Guia de implementação

Transações

Transferências

Contestações

Certificados

Headers

Path

Resposta

​Certificados

​Headers

​Path

​Resposta

Certificados

Headers

Path

Resposta