MED 列表

列出与账户关联的 MED（特殊退款机制）流程。

MED 是巴西中央银行针对 PIX 系统中的欺诈或操作故障而设立的资金追回机制。

接口

GET /api/external/med

请求头

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

示例

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

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

字段	类型	说明
worked	Boolean	true 表示操作成功
meds	Array	MED 流程列表
meds[].id	String	MED 唯一标识符
meds[].type	String	MED 类型（见下表）
meds[].status	String	流程当前状态
meds[].amount	Integer	金额，单位为基本单位 (÷ 10,000 得到雷亚尔)。50000 = R$ 5.00
meds[].original_end_to_end_id	String	原始 PIX 交易的 E2E ID
meds[].created_at	String	创建日期（ISO 8601）

MED 类型

类型	说明
FRAUDE	涉嫌欺诈或诈骗
FALHA_OPERACIONAL	系统处理故障

MED 状态

状态	说明
pending	MED 审核中
accepted	MED 已受理 -- 账户资金已冻结
refunded	资金已退还给原付款方
rejected	审核后 MED 被驳回
cancelled	MED 已取消

成功响应 -- 无 MED 记录 (200)

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

错误响应 (401)

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

资金冻结

当 MED 被受理（accepted）时，相应金额将被冻结，并从可用余额中扣除。可通过 MED 详情 和 Webhook pix.med 进行跟踪。