跳到主要内容

MED 2.0 — 查询资金追回

除了后续的 webhook 之外，您还可以查询针对您发起的资金追回：列表接口返回所有已收到的资金追回，单项查询接口通过 funds_recovery_id（与 webhook 中收到的标识符相同）返回某个资金追回的详细信息。

列出资金追回​

ENDPOINT
/internal/pix/funds_recovery/incoming
方法
GET

Query params​

字段类型描述
funds_recovery_statusstring按资金追回状态过滤：awaiting_analysis、pending_approval、completed 或 cancelled。
initial_datestring过滤从该日期起创建的资金追回。格式 YYYY-MM-DD。
final_datestring过滤截至该日期创建的资金追回。格式 YYYY-MM-DD。
page_numberinteger列表页码。默认：1。
page_sizeinteger每页条目数。默认：10，最大：30。

Response​

STATUS
200
Response Body
{
  "data": [
    {
      "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": "awaiting_analysis",
      "situation_type": "scam",
      "report_details": "交易被发起方标记为欺诈。",
      "infraction_amount": 150.50,
      "credited_participant": "32402502",
      "debited_participant": "12345678",
      "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"
        }
      ],
      "updated_at": "2026-07-16T16:48:43Z",
      "created_at": "2026-07-16T16:48:43Z"
    }
  ],
  "pagination": {
    "current_page": 1,
    "next_page": null,
    "rows_per_page": 10
  }
}
字段类型描述
data *array针对您发起的资金追回列表，从最新到最旧排序。funds_recovery 对象
pagination *object分页数据：current_page、next_page（最后一页为 null）和 rows_per_page。

查询单个资金追回​

ENDPOINT
/internal/pix/funds_recovery/incoming/FUNDS_RECOVERY_ID
方法
GET

Path params​

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

Response​

STATUS
200

响应为 funds_recovery 对象，包含状态事件历史（funds_recovery_status_events），且当资金追回已被回复时，还包含 client_awnser 字段。