Liste MED

Liste les processus MED (Mecanisme Special de Restitution) associes au compte.

Le MED est un mecanisme de la Banque Centrale pour la recuperation de fonds en cas de fraude ou de defaillance operationnelle dans le systeme PIX.

Endpoint

GET /api/external/med

En-tetes

En-tete	Type	Obligatoire	Description
Authorization	String	Oui	ApiKey {client_id}:{client_secret}

Exemple

curl -X GET https://api.owem.com.br/api/external/med \
  -H "Authorization: ApiKey $CLIENT_ID:$CLIENT_SECRET"

Reponse de succes (200)

{
  "worked": true,
  "meds": [
    {
      "id": "MED20260307001",
      "type": "FRAUDE",
      "status": "pending",
      "amount": 50000,
      "original_end_to_end_id": "E37839059202603071530000001",
      "created_at": "2026-03-07T18:00:00Z"
    },
    {
      "id": "MED20260305002",
      "type": "FALHA_OPERACIONAL",
      "status": "refunded",
      "amount": 15000,
      "original_end_to_end_id": "E37839059202603051200000003",
      "created_at": "2026-03-05T14:30:00Z"
    }
  ]
}

Champ	Type	Description
worked	Boolean	true indique le succes de l'operation
meds	Array	Liste des processus MED
meds[].id	String	Identifiant unique du MED
meds[].type	String	Type du MED (voir tableau ci-dessous)
meds[].status	String	Statut actuel du processus
meds[].amount	Integer	Valeur en unites de base (÷ 10 000 pour les reais). 50000 = R$ 5,00
meds[].original_end_to_end_id	String	E2E de la transaction PIX d'origine
meds[].created_at	String	Date d'ouverture (ISO 8601)

Types de MED

Type	Description
FRAUDE	Suspicion de fraude ou d'escroquerie
FALHA_OPERACIONAL	Defaillance dans le traitement du systeme

Statut du MED

Statut	Description
pending	MED en cours d'analyse
accepted	MED accepte -- fonds bloques sur le compte
refunded	Fonds restitues au payeur d'origine
rejected	MED rejete apres analyse
cancelled	MED annule

Reponse de succes -- Aucun MED (200)

{
  "worked": true,
  "meds": []
}

Reponse d'erreur (401)

{
  "error": {
    "status": 401,
    "message": "Missing API key credentials. Use Authorization: ApiKey <client_id>:<client_secret>"
  }
}

Blocage de fonds

Lorsqu'un MED est accepte (accepted), les fonds correspondants sont bloques sur le compte et deduits du solde disponible. Suivez l'evolution via Details MED et Webhook pix.med.