curl -X GET "https://carteira.nevermissapps.com/v1/meds" \
-H "Authorization: Bearer SUA_API_KEY"
curl -X GET "https://carteira.nevermissapps.com/v1/meds?status=pending" \
-H "Authorization: Bearer SUA_API_KEY"
curl -X GET "https://carteira.nevermissapps.com/v1/meds?limit=10&offset=0" \
-H "Authorization: Bearer SUA_API_KEY"
// Listar todos
const response = await fetch('https://carteira.nevermissapps.com/v1/meds', {
headers: { 'Authorization': 'Bearer SUA_API_KEY' }
});
// Filtrar por status
const pendingResponse = await fetch(
'https://carteira.nevermissapps.com/v1/meds?status=pending',
{ headers: { 'Authorization': 'Bearer SUA_API_KEY' } }
);
const meds = await response.json();
console.log(`Total de MEDs: ${meds.total}`);
import requests
# Listar todos
response = requests.get(
'https://carteira.nevermissapps.com/v1/meds',
headers={'Authorization': 'Bearer SUA_API_KEY'}
)
# Filtrar por status
response = requests.get(
'https://carteira.nevermissapps.com/v1/meds',
headers={'Authorization': 'Bearer SUA_API_KEY'},
params={'status': 'pending', 'limit': 50}
)
meds = response.json()
print(f"Total de MEDs: {meds['total']}")
{
"success": true,
"total": 3,
"count": 3,
"offset": 0,
"limit": 50,
"meds": [
{
"infractionId": "INF123456789",
"txid": "ABC123XYZ",
"amount": 150.00,
"frozenAmount": 139.51,
"status": "pending",
"analysisStatus": "pending",
"situationType": "FRAUDE",
"infractionDate": "2025-11-25T14:30:00.000Z",
"description": "Cliente alega não reconhecer a transação",
"dueDate": "2025-12-02T23:59:59.000Z",
"payerName": "João Silva",
"createdAt": "2025-11-25T15:30:00.000Z",
"resolvedAt": null
},
{
"infractionId": "INF987654321",
"txid": "DEF456ABC",
"amount": 89.90,
"frozenAmount": 83.62,
"status": "disagreed",
"analysisStatus": "rejected",
"situationType": "ERRO",
"infractionDate": "2025-11-20T10:15:00.000Z",
"description": "Valor incorreto cobrado",
"dueDate": "2025-11-27T23:59:59.000Z",
"payerName": "Maria Santos",
"createdAt": "2025-11-20T10:35:00.000Z",
"resolvedAt": "2025-11-24T11:35:00.000Z"
}
]
}
{
"success": true,
"total": 0,
"count": 0,
"offset": 0,
"limit": 50,
"meds": []
}
{
"success": false,
"message": "Status inválido. Use: pending, agreed, disagreed, canceled"
}
API - MEDs (Contestações)
Listar MEDs
Lista todas as suas contestações PIX (MEDs) com filtros e paginação
GET
/
v1
/
meds
curl -X GET "https://carteira.nevermissapps.com/v1/meds" \
-H "Authorization: Bearer SUA_API_KEY"
curl -X GET "https://carteira.nevermissapps.com/v1/meds?status=pending" \
-H "Authorization: Bearer SUA_API_KEY"
curl -X GET "https://carteira.nevermissapps.com/v1/meds?limit=10&offset=0" \
-H "Authorization: Bearer SUA_API_KEY"
// Listar todos
const response = await fetch('https://carteira.nevermissapps.com/v1/meds', {
headers: { 'Authorization': 'Bearer SUA_API_KEY' }
});
// Filtrar por status
const pendingResponse = await fetch(
'https://carteira.nevermissapps.com/v1/meds?status=pending',
{ headers: { 'Authorization': 'Bearer SUA_API_KEY' } }
);
const meds = await response.json();
console.log(`Total de MEDs: ${meds.total}`);
import requests
# Listar todos
response = requests.get(
'https://carteira.nevermissapps.com/v1/meds',
headers={'Authorization': 'Bearer SUA_API_KEY'}
)
# Filtrar por status
response = requests.get(
'https://carteira.nevermissapps.com/v1/meds',
headers={'Authorization': 'Bearer SUA_API_KEY'},
params={'status': 'pending', 'limit': 50}
)
meds = response.json()
print(f"Total de MEDs: {meds['total']}")
{
"success": true,
"total": 3,
"count": 3,
"offset": 0,
"limit": 50,
"meds": [
{
"infractionId": "INF123456789",
"txid": "ABC123XYZ",
"amount": 150.00,
"frozenAmount": 139.51,
"status": "pending",
"analysisStatus": "pending",
"situationType": "FRAUDE",
"infractionDate": "2025-11-25T14:30:00.000Z",
"description": "Cliente alega não reconhecer a transação",
"dueDate": "2025-12-02T23:59:59.000Z",
"payerName": "João Silva",
"createdAt": "2025-11-25T15:30:00.000Z",
"resolvedAt": null
},
{
"infractionId": "INF987654321",
"txid": "DEF456ABC",
"amount": 89.90,
"frozenAmount": 83.62,
"status": "disagreed",
"analysisStatus": "rejected",
"situationType": "ERRO",
"infractionDate": "2025-11-20T10:15:00.000Z",
"description": "Valor incorreto cobrado",
"dueDate": "2025-11-27T23:59:59.000Z",
"payerName": "Maria Santos",
"createdAt": "2025-11-20T10:35:00.000Z",
"resolvedAt": "2025-11-24T11:35:00.000Z"
}
]
}
{
"success": true,
"total": 0,
"count": 0,
"offset": 0,
"limit": 50,
"meds": []
}
{
"success": false,
"message": "Status inválido. Use: pending, agreed, disagreed, canceled"
}
Descrição
Retorna uma lista paginada de todas as suas MEDs (Mecanismo Especial de Devolução), também conhecidas como contestações PIX. MEDs ocorrem quando um pagador contesta uma transação PIX junto ao seu banco.O que é MED?: MED é o Mecanismo Especial de Devolução criado pelo Banco Central. Quando um cliente contesta um PIX alegando fraude ou erro, o valor pode ser congelado em sua conta até a resolução.
Headers
string
required
Bearer token com sua API Key
Query Parameters (todos opcionais)
string
Filtrar por status:
pending, agreed, disagreed, cancelednumber
default:50
Quantidade de resultados por página (máximo: 100)
number
default:0
Deslocamento para paginação
Status do MED
| Status | Descrição |
|---|---|
pending | Contestação recebida, aguardando análise |
agreed | Você concordou com a contestação |
disagreed | Você discordou da contestação |
canceled | Contestação foi cancelada |
Response
boolean
Indica se a operação foi bem-sucedida
number
Total de MEDs encontrados
number
Quantidade retornada nesta página
number
Offset utilizado
number
Limite utilizado
array
Lista de MEDs
Show MED object
Show MED object
string
ID único da infração/contestação
string
ID da transação original contestada
number
Valor da transação contestada
number
Valor congelado em sua conta
string
Status atual do MED
string
Status da análise:
pending, accepted, rejectedstring
Tipo da situação reportada
string
Data da infração
string
Descrição da contestação
string
Prazo para análise
string
Nome do pagador que contestou
string
Data de criação (formato ISO 8601)
string
Data de resolução (se resolvido) - formato ISO 8601
curl -X GET "https://carteira.nevermissapps.com/v1/meds" \
-H "Authorization: Bearer SUA_API_KEY"
curl -X GET "https://carteira.nevermissapps.com/v1/meds?status=pending" \
-H "Authorization: Bearer SUA_API_KEY"
curl -X GET "https://carteira.nevermissapps.com/v1/meds?limit=10&offset=0" \
-H "Authorization: Bearer SUA_API_KEY"
// Listar todos
const response = await fetch('https://carteira.nevermissapps.com/v1/meds', {
headers: { 'Authorization': 'Bearer SUA_API_KEY' }
});
// Filtrar por status
const pendingResponse = await fetch(
'https://carteira.nevermissapps.com/v1/meds?status=pending',
{ headers: { 'Authorization': 'Bearer SUA_API_KEY' } }
);
const meds = await response.json();
console.log(`Total de MEDs: ${meds.total}`);
import requests
# Listar todos
response = requests.get(
'https://carteira.nevermissapps.com/v1/meds',
headers={'Authorization': 'Bearer SUA_API_KEY'}
)
# Filtrar por status
response = requests.get(
'https://carteira.nevermissapps.com/v1/meds',
headers={'Authorization': 'Bearer SUA_API_KEY'},
params={'status': 'pending', 'limit': 50}
)
meds = response.json()
print(f"Total de MEDs: {meds['total']}")
{
"success": true,
"total": 3,
"count": 3,
"offset": 0,
"limit": 50,
"meds": [
{
"infractionId": "INF123456789",
"txid": "ABC123XYZ",
"amount": 150.00,
"frozenAmount": 139.51,
"status": "pending",
"analysisStatus": "pending",
"situationType": "FRAUDE",
"infractionDate": "2025-11-25T14:30:00.000Z",
"description": "Cliente alega não reconhecer a transação",
"dueDate": "2025-12-02T23:59:59.000Z",
"payerName": "João Silva",
"createdAt": "2025-11-25T15:30:00.000Z",
"resolvedAt": null
},
{
"infractionId": "INF987654321",
"txid": "DEF456ABC",
"amount": 89.90,
"frozenAmount": 83.62,
"status": "disagreed",
"analysisStatus": "rejected",
"situationType": "ERRO",
"infractionDate": "2025-11-20T10:15:00.000Z",
"description": "Valor incorreto cobrado",
"dueDate": "2025-11-27T23:59:59.000Z",
"payerName": "Maria Santos",
"createdAt": "2025-11-20T10:35:00.000Z",
"resolvedAt": "2025-11-24T11:35:00.000Z"
}
]
}
{
"success": true,
"total": 0,
"count": 0,
"offset": 0,
"limit": 50,
"meds": []
}
{
"success": false,
"message": "Status inválido. Use: pending, agreed, disagreed, canceled"
}
Impacto nos Saques
Saldo congelado: Quando você tem MEDs pendentes, o valor correspondente (
frozenAmount) é congelado e não pode ser sacado. Isso afeta seu saldo disponível.// Verificar impacto no saldo
const medsResponse = await fetch(
'https://carteira.nevermissapps.com/v1/meds?status=pending',
{ headers: { 'Authorization': `Bearer ${API_KEY}` } }
);
const { meds } = await medsResponse.json();
const totalFrozen = meds.reduce((sum, med) => sum + med.frozenAmount, 0);
console.log(`Valor total congelado por MEDs: R$ ${totalFrozen.toFixed(2)}`);
Próximos Passos
Resumo de MEDs
Veja estatísticas consolidadas dos seus MEDs
Detalhes do MED
Consulte informações detalhadas de um MED específico