Details MED

Consulte les details complets d'un processus MED (Mecanisme Special de Restitution) specifique.

Endpoint

GET /api/external/med/:id

En-tetes

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

Parametres de chemin

Parametre	Type	Obligatoire	Description
id	String	Oui	Identifiant du processus MED

Exemple

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

Reponse de succes (200)

{
  "worked": true,
  "med": {
    "id": "MED20260307001",
    "type": "FRAUDE",
    "status": "accepted",
    "amount": 50000,
    "original_end_to_end_id": "E37839059202603071530000001",
    "original_transaction_id": "PIXIN20260307a1b2c3d4e5f6",
    "requester_ispb": "12345678",
    "reason": "Fraude reportada pelo pagador",
    "created_at": "2026-03-07T18:00:00Z",
    "tracking": {
      "notification_received": "2026-03-07T18:00:00Z",
      "funds_blocked": "2026-03-07T18:00:05Z",
      "analysis_completed": null,
      "refund_completed": null
    }
  }
}

Champ	Type	Description
worked	Boolean	true indique le succes de l'operation
med.id	String	Identifiant unique du MED
med.type	String	Type : FRAUDE ou FALHA_OPERACIONAL
med.status	String	Statut actuel du processus
med.amount	Integer	Valeur en unites de base (÷ 10 000 pour les reais)
med.original_end_to_end_id	String	E2E de la transaction PIX d'origine
med.original_transaction_id	String	ID de la transaction PIX d'origine
med.requester_ispb	String	ISPB de l'etablissement demandeur
med.reason	String	Motif indique par le demandeur
med.created_at	String	Date d'ouverture (ISO 8601)
med.tracking	Object	Historique des etapes du processus

Champs de tracking

Champ	Type	Description
notification_received	String	Date de reception de la notification MED
funds_blocked	String	Date du blocage des fonds (null si non bloque)
analysis_completed	String	Date de fin de l'analyse (null si en attente)
refund_completed	String	Date de la restitution des fonds (null si non restitue)

Reponse d'erreur (404)

{
  "worked": false,
  "detail": "MED nao encontrado"
}

Reponse d'erreur (401)

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

Suivi

Utilisez les Webhooks avec l'evenement pix.med pour etre notifie des changements de statut du MED en temps reel.