跳到主要内容

MED 2.0 — 回复资金追回

当资金追回处于 awaiting_analysis 状态时，您可以对其进行回复，证明交易的合法性。回复由一段文字说明和一个 .zip 证据文件（发票、凭证、对话记录等）组成，以 multipart/form-data 形式发送。

回复后，资金追回将进入 pending_approval 状态，进入分析阶段。

警告

回复 MED 的最长期限为 5 天。

资金追回标识符​

路由中使用的标识符是 funds_recovery_id 字段，在资金追回创建时通过 incoming funds recovery webhook 接收：

{
  "event_datetime": "2026-07-16T16:48:43Z",
  "key": "0dedf537-a75e-4945-be1d-5d278c623022",
  "data": {
    "funds_recovery_id": "b8d19bd4-51dc-4784-a2ad-52807c6dfc80",
    "funds_recovery_status": "awaiting_analysis",
    "...": "..."
  },
  "status": "awaiting_analysis",
  "webhook_type": "incoming.internal_infraction_report"
}

同一标识符也可以通过**资金追回列表**获取。

Request​

ENDPOINT
/pix/funds_recovery/incoming/FUNDS_RECOVERY_ID
方法
PATCH

Path params​

字段类型描述字符数
FUNDS_RECOVERY_ID *string资金追回在巴西央行（Bacen）的标识符（funds_recovery_id）。32

Form data​

字段类型描述字符数
client_awnser *string您对被标记为欺诈的交易的说明。2000
file *file包含支持说明的证据的 .zip 文件。最大大小：50MB。-

Response​

STATUS
200
Response Body
{
  "funds_recovery_key": "9eb5f452-81fd-4f67-9f2a-49e14e53ef64",
  "funds_recovery_id": "b8d19bd4-51dc-4784-a2ad-52807c6dfc80",
  "infraction_report_id": "3541127e-cbc9-44f6-bb0e-3e346ddaefb4",
  "pix_transfer_key": "957ef961-1824-47e6-90fd-f8b4775a1e1c",
  "target_account_key": "6711e3cf-fdf4-41b4-88e8-0a31cb83b9f4",
  "target_person_key": "4f6ea994-e53a-4ef8-b2b0-89d14c4667bc",
  "end_to_end_id": "E12345678202607161648s188f18bJty",
  "funds_recovery_status": "pending_approval",
  "situation_type": "scam",
  "report_details": "交易被发起方标记为欺诈。",
  "infraction_amount": 150.50,
  "credited_participant": "32402502",
  "debited_participant": "12345678",
  "client_awnser": "合法交易，发票 XXXXXXXXXX 可证明该商品的销售。",
  "analysis_result": null,
  "analysis_details": null,
  "blocked_balance_status": "completelly_blocked",
  "tracking_graph": null,
  "funds_recovery_status_events": [
    {
      "old_status": null,
      "new_status": "awaiting_analysis",
      "created_at": "2026-07-16T16:48:43Z"
    },
    {
      "old_status": "awaiting_analysis",
      "new_status": "pending_approval",
      "created_at": "2026-07-17T10:12:05Z"
    }
  ],
  "updated_at": "2026-07-17T10:12:05Z",
  "created_at": "2026-07-16T16:48:43Z"
}

响应为更新后的 funds_recovery 对象，其中 funds_recovery_status = pending_approval，说明在 client_awnser 字段中。

错误​

代码状态描述
QIT000001400请求中缺少 client_awnser 或 file。
MED000042400资金追回不处于 awaiting_analysis 状态。
MED000043400发送的文件不是 .zip 文件。
MED000044400发送的文件超过 50MB 的最大大小。
MED000039404未找到给定 FUNDS_RECOVERY_ID 对应的资金追回。