MED Contestation Management

Introdução

The MED (Special Refund Mechanism), established by the Central Bank of Brazil, is a solution designed to ensure security and efficiency in transactions carried out via Pix. Through the MED Contestation Management platform, end users will be able to register, check, and cancel disputes, ensuring access to information, data protection, as well as greater efficiency in service and transparency in the process.

❗️
Regulatory Obligation

Features

Dispute Registration

Allows users to register disputes related to Pix transactions.

Description: Users can provide details about their disputes, including the reason for the complaint and the type of situation encountered. This ensures that their issues are handled efficiently.

Benefits: Simplifies the dispute process and ensures a prompt response.

{
  "Method": "CreateDispute",
  "PartnerId": 1234,
  "BusinessUnitId": 4321,
  "E2EId": "1234567890abcdef",
  "Description": "Transação suspeita de golpe no valor de R$ 500,00.",
  "SituationType": 0 
}

{
  "Sucess": "true",
  "Message": "Contestação registrada com sucesso.",
  "ProtocolId": "XYZ-123456"
}

Parameter	Description	Mandatory	Type	Comments
Method	Method or action to be executed in the request	Yes	String
PartnerId	Partner identifier	Yes	String
BusinessUnitId	Identifier of the business unit	Yes	String
E2EId	Transaction identification	Yes	String
Description	Description and details regarding the dispute	No	String	2 mil caracteres
SituationType	Type of dispute situation	Yes	Integer	Fraud = 0 Scam = 1 TechnicalFailure = 2 UnauthorizedTransaction = 3 DuplicatePayment = 4 Other = 5

Dispute Consult by Protocol

Provides the ability to check the details of a specific dispute using the protocol number.

Description: Users can enter the dispute protocol number to access information regarding its status and related details.

Benefits: Ensures transparency in tracking registered disputes.

{
  "Method": "GetDisputeDetails",
  "PartnerId": "{{PartnerId}}",
  "BusinessUnitId": "{{BusinessUnitId}}",
  "ProtocolId": "XYZ-123456"  // Protocolo da contestação a ser consultada
}

{
  "Sucess": "true",
  "DisputeDetails": {
    "E2EId": "1234567890abcdef",
    "Description": "Transação suspeita de golpe no valor de R$ 500,00.",
    "SituationType": 0,  // Usando ENUM para situação
    "Status": 1,         // Usando ENUM para status
    "ReceiverName": "Nome do Recebedor",  // Nome do recebedor
    "TransactionValue": 500.00, // Valor da transação contestada
    "ResponseDeadline": "2023-10-10T15:30:00Z", // Prazo de resposta se a situação estiver em análise
    "CreateDate": "2023-10-02T10:00:00Z"  // Data de criação
    "AmountRefunded": 500.00     // Valor efetivamente devolvido se a contestação foi aprovada
  }
}

Parameter	Description	Mandatory	Type
Method	Method or action to be executed in the request	Yes	String
PartnerId	Partner identifier	Yes	String
BusinessUnitId	Identifier of the business unit	Yes	String
ProtocolId	Identification Protocol generated upon dispute registration	Yes	String

Dispute Consultation by Account

Allows users to view all registered disputes associated with their account.

Description: The API provides a way for users to consult their disputes quickly based on bank account information.

Benefits: Speed in accessing information and improved dispute management.

{
  "Method": "GetDisputes",
  "PartnerId": "{{PartnerId}}",
  "BusinessUnitId": "{{BusinessUnitId}}",
  "Bank": "450",                    // Código do banco
  "BankBranch": "0001",             // Agência bancária
  "BankAccount": "1635800010",      // Número da conta bancária
  "BankAccountDigit": "0"            // Dígito da conta bancária
}

{
  "Sucess": "true",
  "Disputes": [
    {
      "ProtocolId": "XYZ-123456",
      "ReceiverName": "Nome do Recebedor",
      "TransactionValue": 500.00,
      "Status": 1,
    },
    {
      "ProtocolId": "XYZ-123478",
      "ReceiverName": "Nome do Recebedor",
      "TransactionValue": 100.00,
      "Status": 0,
    }
  ]
}

Parameter	Description	Mandatory	Type
Method	Method or action to be executed in the request	Yes	String
PartnerId	Partner identifier	Yes	String
BusinessUnitId	Identifier of the business unit	Yes	String
Bank	Bank code of the user performing the action	Yes	String
BankBranch	Bank branch code of the user performing the action	Yes	String
BankAccount	Bank account number of the user performing the action	Yes	String
BankAccountDigit	Bank account digit of the user performing the action	Yes	String

Cancelamento de Contestações

Capacite os usuários a cancelar contestações previamente registradas.

Descrição: Os usuários podem solicitar o cancelamento de uma contestação fornecendo um número de protocolo.

Benefícios: Fornece flexibilidade e controle sobre as contestações registradas.

{
  "Method": "CancelDispute",
  "PartnerId": "{{PartnerId}}",
  "BusinessUnitId": "{{BusinessUnitId}}",
  "ProtocolId": "XYZ-123456"
}

{
  "Sucess": "true",
  "Message": "Contestação cancelada com sucesso.",
  "ProtocolId": "XYZ-123456"
}

Parameter	Description	Mandatory	Type
Method	Method or action to be executed in the request	Yes	String
PartnerId	Partner identifier	Yes	String
BusinessUnitId	Identifier of the business unit	Yes	String
ProtocolId	Identification Protocol generated upon dispute registration	Yes	String

Upload de Arquivos para Comprovação

Permita que os usuários façam upload de documentos e imagens como evidências ao registrar uma contestação.

Descrição: Os usuários podem anexar provas (como prints de conversas e documentos) relevantes para apoiar suas contestações.

Benefícios: Aumenta a eficácia das contestações, permitindo que os usuários forneçam evidências substanciais.

{
    "Method": "UploadFilesDispute",
    "PartnerId": "{{PartnerId}}",
    "BusinessUnitId": "{{BusinessUnitId}}",
    "ProtocolId": "XYZ-123456",
    "Files": [
        {
            "DocumentFile": "/9j/4AAQSkZJRgABAQEAYABgAAD=",
            "DocumentFormat": 0,
            "DocumentName": "Documento 1",
            "Description": "Documento 1"
        }
    ]
}

{
  "Sucess": "true",
  "Message": "Arquivos enviados com sucesso."
}

Parameter	Description	Mandatory	Type	Comments
Method	Method or action to be executed in the request	Yes	String
PartnerId	Partner identifier	Yes	String
BusinessUnitId	Identifier of the business unit	Yes	String
ProtocolId	Identification Protocol generated upon dispute registration	Yes	String
Files	Object for sending the files	Yes	String
DocumentFile	File encoded in Base64	Yes	String
DocumentFormat	Type of file format	Yes	String	PDF = 0 JPG = 1 JPEG = 2 TXT = 3 PNG = 4
DocumentName	Name of the Uploaded File	Yes	String
Description	Description and Details of the File	Yes	String

Introdução

❗️Regulatory Obligation

Features

Dispute Registration

Dispute Consult by Protocol

Dispute Consultation by Account

Cancelamento de Contestações

Upload de Arquivos para Comprovação

❗️
Regulatory Obligation