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

Dispute Cancellation

Empowers users to cancel previously registered disputes.

Description: Users can request the cancellation of a dispute by providing a protocol number.

Benefits: Provides flexibility and control over registered disputes.

{
  "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

File Upload for Proof

Allows users to upload documents and images as evidence when registering a dispute.

Description: Users can attach relevant evidence (such as conversation screenshots and documents) to support their disputes.

Benefits: Increases the effectiveness of disputes by allowing users to provide substantial evidence.

{
    "Method": "UploadFilesDispute",
    "PartnerId": "{{PartnerId}}",
    "BusinessUnitId": "{{BusinessUnitId}}",
    "ProtocolId": "XYZ-123456",
    "Files": [
        {
            "DocumentFile": "/9j/4AAQSkZJRgABAQEAYABgAAD=",
            "DocumentFormat": 0,
            "DocumentName": "Documento 1.pdf",
            "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

Dispute Cancellation

File Upload for Proof

❗️
Regulatory Obligation