Skip to main content

​
Visão Geral

O evento MED é disparado quando o status de um MED (Mecanismo Especial de Devolução) é atualizado na plataforma. O webhook é enviado quando:
  • Um MED é recebido
  • Um MED muda de status (ex: PENDING → PROCESSING, PROCESSING → ACCEPTED)
  • Um MED é resolvido

​
Headers do Webhook

X-Webhook-Event: MED
X-Webhook-Timestamp: 2024-01-15T12:00:00Z
X-Webhook-Signature: abc123def456...
Content-Type: application/json

​
Estrutura do Payload

{
  "event": "MED",
  "timestamp": "2024-01-15T12:00:00Z",
  "data": {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "pix_in_transaction": {
      "uuid": "660e8400-e29b-41d4-a716-446655440001",
      "initiation": {
        "sender": {
          "name": "João Silva",
          "document": "12345678900",
          "account_number": "12345678",
          "account_agency": "0001",
          "bank": {
            "code": "001",
            "name": "Banco Exemplo",
            "ispb": "00000000"
          },
          "account_type": "PAYMENT"
        },
        "receiver": {
          "name": "Empresa Exemplo LTDA",
          "document": "12345678000199",
          "account_number": "87654321",
          "account_agency": "0001",
          "bank": {
            "code": "002",
            "name": "Banco Recebedor",
            "ispb": "00000001"
          },
          "account_type": "CHECKING"
        },
        "txid": "txid123456789abcdef",
        "value": "150.00",
        "type": "QR_DYNAMIC",
        "pix_key": "770e8400-e29b-41d4-a716-446655440002",
        "status": "COMPLETED",
        "expires_at": "2024-01-02T23:59:59.000000Z",
        "created_at": "2024-01-01T10:00:00.000000Z",
        "updated_at": "2024-01-01T10:05:00.000000Z"
      },
      "value": "150.00",
      "movement_type": "IN",
      "type": "EXTERNAL_TRANSFER",
      "status": "SETTLED",
      "end_to_end": "E00000000202401011000abcdef12345",
      "settled_at": "2024-01-01T10:05:00.000000Z",
      "created_at": "2024-01-01T10:05:00.000000Z",
      "updated_at": "2024-01-01T10:05:00.000000Z"
    },
    "attachments": [
      {
        "uuid": "990e8400-e29b-41d4-a716-446655440004",
        "url": "https://app.plowf.com/attachments/meds/550e8400-e29b-41d4-a716-446655440000/990e8400-e29b-41d4-a716-446655440004.jpg"
      }
    ],
    "med_type": "RECEIVED_MED",
    "dispute_type": "SCAM",
    "status": "PROCESSING",
    "details": "01",
    "analysis": null,
    "resolved": false,
    "created_at": "2024-01-15T12:00:00.000000Z",
    "updated_at": "2024-01-15T12:00:00.000000Z"
  }
}

​
Campos do Payload

​
event
string
Tipo do evento. Sempre "MED" para este webhook.
​
timestamp
datetime
Timestamp ISO 8601 do momento em que o webhook foi enviado.
​
data
object
Dados do MED atualizado.

​
Status Possíveis

Os status possíveis para um MED são:
  • PENDING - Aguardando processamento
  • PROCESSING - MED em processamento
  • ACCEPTED - MED aceito
  • REJECTED - MED rejeitado
  • CANCELLED - MED cancelado

​
Tipos de Disputa

Os tipos de disputa possíveis são:
  • UNDEFINED - Tipo não definido
  • SCAM - Fraude/golpe
  • WRONG_TRANSACTION - Transação incorreta
  • COERCION_CRIME - Crime de coação
  • UNAUTHORIZED_ACCESS - Acesso não autorizado
Use o campo uuid para identificar unicamente o MED e implementar idempotência no seu endpoint. O webhook será enviado a cada mudança de status, então é importante tratar eventos duplicados.
MEDs possuem prazo para resposta. Monitore os eventos de MED e responda dentro do prazo estabelecido pelo Banco Central para evitar aprovação automática.