Overview
Authentication
Bank Account
Webhooks
List MEDs
Copy
curl --request GET \
--url https://api.owem.com.br/v4/i/meds \
--header 'Authorization: <authorization>'Copy
{
"requestId": "a111b222-c333-4d44-8e55-f66677788899",
"success": true,
"size": 1,
"pagination": {
"page": 1,
"limit": 50,
"orderBy": "desc",
"total": 1,
"totalPages": 1
},
"data": [
{
"endToEndId": "E123456789202512240000000000001",
"medId": "med_12345678-abcd-efgh-ijkl-123456789abc",
"createdInfractionAt": 1766523042000,
"pspCreatorName": "OTHER PAYMENT INSTITUTION LTD.",
"payer": {
"ispb": "12345678",
"personType": "person",
"cpfCnpj": "XXX123456XX",
"name": "JOHN DOE",
"agency": "0001",
"accountType": "savings",
"accountNumber": "123456"
},
"details": "Transaction contested by paying user",
"feeAmount": 0,
"netAmount": 0,
"grossAmount": 150.0,
"transactionCreatedAt": 1766436642000,
"receiver": {
"ispb": "87654321",
"personType": "company",
"agency": "0001",
"accountType": "checking",
"name": "MY COMPANY LTD",
"cpfCnpj": "XX123456000XXX",
"accountNumber": "987654321012"
},
"userId": "usr_abc123def",
"status": "under_analysis",
"defense": {
"description": "Attached all proof of negotiation with customer",
"createdAt": 1766609442000,
"files": ["https://storage.owem.com.br/files/defense-001.pdf"]
},
"deadlines": {
"defenseDeadLine": 1766782086000
},
"legalAnalysis": {
"createdAt": 1766695686000,
"createdBy": "[email protected]",
"considerations": "Customer proved product was delivered"
}
}
]
}
MEDs
List MEDs
Returns the list of MEDs (Special Refund Mechanism) received. Manage PIX disputes with filters by status and pagination.
GET
https://api.owem.com.br
/
v4
/
i
/
meds
List MEDs
Copy
curl --request GET \
--url https://api.owem.com.br/v4/i/meds \
--header 'Authorization: <authorization>'Copy
{
"requestId": "a111b222-c333-4d44-8e55-f66677788899",
"success": true,
"size": 1,
"pagination": {
"page": 1,
"limit": 50,
"orderBy": "desc",
"total": 1,
"totalPages": 1
},
"data": [
{
"endToEndId": "E123456789202512240000000000001",
"medId": "med_12345678-abcd-efgh-ijkl-123456789abc",
"createdInfractionAt": 1766523042000,
"pspCreatorName": "OTHER PAYMENT INSTITUTION LTD.",
"payer": {
"ispb": "12345678",
"personType": "person",
"cpfCnpj": "XXX123456XX",
"name": "JOHN DOE",
"agency": "0001",
"accountType": "savings",
"accountNumber": "123456"
},
"details": "Transaction contested by paying user",
"feeAmount": 0,
"netAmount": 0,
"grossAmount": 150.0,
"transactionCreatedAt": 1766436642000,
"receiver": {
"ispb": "87654321",
"personType": "company",
"agency": "0001",
"accountType": "checking",
"name": "MY COMPANY LTD",
"cpfCnpj": "XX123456000XXX",
"accountNumber": "987654321012"
},
"userId": "usr_abc123def",
"status": "under_analysis",
"defense": {
"description": "Attached all proof of negotiation with customer",
"createdAt": 1766609442000,
"files": ["https://storage.owem.com.br/files/defense-001.pdf"]
},
"deadlines": {
"defenseDeadLine": 1766782086000
},
"legalAnalysis": {
"createdAt": 1766695686000,
"createdBy": "[email protected]",
"considerations": "Customer proved product was delivered"
}
}
]
}
Purpose
Returns the list of MEDs (Special Refund Mechanism) received by the account, with filter and pagination support. MED is a Brazilian Central Bank mechanism that allows refunds in cases of fraud or operational failure.Authentication
Basic Auth required in format:
Basic {Base64(API_KEY:API_SECRET)}Query Parameters
Filter by MED status (
under_analysis, accepted, rejected, etc.)Start date (timestamp ms)
End date (timestamp ms)
Results page
Items per page (max 100)
Response
UUID for tracking
Operation status
Number of returned items
Array of MEDs
Show item
Show item
E2E identifier of original PIX transaction
Unique MED identifier
Infraction creation timestamp (ms)
Name of institution that created the MED
Payer data (who contested)
Receiver data (your account)
Contest reason description
Contested gross amount
Applied fee
Net amount
Original transaction timestamp (ms)
Affected user ID
MED status (
under_analysis, accepted, rejected)Defense data (if sent)
Important deadlines
Legal analysis (if any)
Copy
{
"requestId": "a111b222-c333-4d44-8e55-f66677788899",
"success": true,
"size": 1,
"pagination": {
"page": 1,
"limit": 50,
"orderBy": "desc",
"total": 1,
"totalPages": 1
},
"data": [
{
"endToEndId": "E123456789202512240000000000001",
"medId": "med_12345678-abcd-efgh-ijkl-123456789abc",
"createdInfractionAt": 1766523042000,
"pspCreatorName": "OTHER PAYMENT INSTITUTION LTD.",
"payer": {
"ispb": "12345678",
"personType": "person",
"cpfCnpj": "XXX123456XX",
"name": "JOHN DOE",
"agency": "0001",
"accountType": "savings",
"accountNumber": "123456"
},
"details": "Transaction contested by paying user",
"feeAmount": 0,
"netAmount": 0,
"grossAmount": 150.0,
"transactionCreatedAt": 1766436642000,
"receiver": {
"ispb": "87654321",
"personType": "company",
"agency": "0001",
"accountType": "checking",
"name": "MY COMPANY LTD",
"cpfCnpj": "XX123456000XXX",
"accountNumber": "987654321012"
},
"userId": "usr_abc123def",
"status": "under_analysis",
"defense": {
"description": "Attached all proof of negotiation with customer",
"createdAt": 1766609442000,
"files": ["https://storage.owem.com.br/files/defense-001.pdf"]
},
"deadlines": {
"defenseDeadLine": 1766782086000
},
"legalAnalysis": {
"createdAt": 1766695686000,
"createdBy": "[email protected]",
"considerations": "Customer proved product was delivered"
}
}
]
}
Status Codes
| HTTP | Description |
|---|---|
| 200 | List returned |
| 400 | Invalid parameter |
| 401 | Invalid credentials |
| 403 | IP not allowlisted |
| 429 | Rate limit exceeded |
| 500 | Internal error |
MED Status
| Status | Description |
|---|---|
under_analysis | MED under analysis |
accepted | MED accepted (amount refunded) |
rejected | MED rejected (amount kept) |
MEDs have a defense deadline. Check the
deadlines.defenseDeadLine field
and submit your defense before it expires.Configure a webhook for
med:received to be immediately notified when a
new MED is received.Was this page helpful?
⌘I