MED 详情

查询指定 MED（特殊退款机制）流程的完整详情。

接口

GET /api/external/med/:id

请求头

请求头	类型	必填	说明
Authorization	String	是	ApiKey {client_id}:{client_secret}

路径参数

参数	类型	必填	说明
id	String	是	MED 流程标识符

示例

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

成功响应 (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
    }
  }
}

字段	类型	说明
worked	Boolean	true 表示操作成功
med.id	String	MED 唯一标识符
med.type	String	类型：FRAUDE 或 FALHA_OPERACIONAL
med.status	String	流程当前状态
med.amount	Integer	金额，单位为基本单位 (÷ 10,000 得到雷亚尔)
med.original_end_to_end_id	String	原始 PIX 交易的 E2E ID
med.original_transaction_id	String	原始 PIX 交易 ID
med.requester_ispb	String	发起请求机构的 ISPB
med.reason	String	发起方提供的原因说明
med.created_at	String	创建日期（ISO 8601）
med.tracking	Object	流程各阶段的时间记录

tracking 字段

字段	类型	说明
notification_received	String	MED 通知接收时间
funds_blocked	String	资金冻结时间（未冻结时为 null）
analysis_completed	String	审核完成时间（待审核时为 null）
refund_completed	String	资金退还时间（未退还时为 null）

错误响应 (404)

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

错误响应 (401)

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

状态跟踪

使用 Webhooks 并订阅 pix.med 事件，可实时接收 MED 状态变更通知。