跳到主要内容

MED 2.0 — 接收资金追回

MED 2.0 引入了资金追回（funds recovery），它将被质疑的 PIX 交易的违规报告和退款请求统一为一个流程。当针对某个账户收到资金追回时，QI Tech 会自动对与被质疑交易等值的资金进行预防性冻结，并通过 webhook 通知您，使您有机会在关闭前证明交易的合法性。

收到的资金追回的生命周期如下：

  1. awaiting_analysis — 已收到资金追回并冻结余额；等待您的回复，您最多有 5 天时间进行回复。
  2. pending_approval — 回复已发送（说明 + 证据文件）；由 QI Tech 进行分析。
  3. completed — 由 QI Tech 关闭，接受（agreed）或拒绝（disagreed）该资金追回。
  4. cancelled — 由发起参与方取消。

所有后续沟通均通过 webhook 进行。

incoming funds recovery 的 Webhook​

Incoming funds recovery 是由另一参与方发起的资金追回，其中您的账户是被质疑交易的目标。

说明

资金追回的 webhook 以 webhook_type incoming.internal_infraction_report 发送。要将其与违规报告区分开，请检查 data 对象中是否存在 funds_recovery_key 字段。

Webhook: incoming funds recovery
{
  "event_datetime": "2026-07-16T16:48:43Z",
  "key": "0dedf537-a75e-4945-be1d-5d278c623022",
  "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,
    "contact_email": "contact@participant.com.br",
    "contact_phone_number": "+5511999999999",
    "credited_participant": "32402502",
    "debited_participant": "12345678",
    "client_details": null,
    "analysis_result": null,
    "analysis_details": null,
    "blocked_balance_status": "completelly_blocked",
    "tracking_graph": null,
    "updated_at": "2026-07-16T16:48:43Z",
    "created_at": "2026-07-16T16:48:43Z"
  },
  "status": "awaiting_analysis",
  "webhook_type": "incoming.internal_infraction_report"
}

funds_recovery 对象​

字段类型描述字符数
funds_recovery_key *string资金追回在 QI Tech 的 UUID4 标识符。32
funds_recovery_id *string资金追回在巴西央行（Bacen）的标识符。用于查询和回复。32
infraction_report_id *string引发该资金追回的违规在巴西央行的标识符。32
pix_transfer_key *string原始交易的 Pix transfer key。32
target_account_key *string原始交易目标账户的 account key。32
target_person_key *string资金追回目标的 person key。32
end_to_end_id *string原始交易的 end_to_end_id。32
funds_recovery_status *string资金追回的状态。funds_recovery_status 枚举
situation_type *string发起方报告的情形。situation_type 枚举
report_detailsstring发起参与方发送的详细信息。2000
infraction_amountnumber被质疑的金额。缺省时视为交易的全部金额。-
contact_emailstring发起参与方的联系邮箱。255
contact_phone_numberstring发起参与方的联系电话。20
credited_participant *string接收交易的参与方。8
debited_participant *string发起交易的参与方。8
client_awnserstring回复中发送的说明。回复后出现。2000
analysis_resultstring分析结果。由 QI Tech 决定。analysis_result 枚举
analysis_detailsstring分析结果的说明。2000
blocked_balance_status *string目标账户的余额冻结状态。blocked_balance_status 枚举
tracking_graphobject被质疑资金流转的追踪图（如有）。-
created_at *string创建日期和时间。20
updated_at *string更新日期和时间。20

funds_recovery_status 枚举​

枚举值描述
awaiting_analysis已收到资金追回并冻结余额，等待您的回复。
pending_approval说明已发送，等待 QI Tech 内部分析。
completed分析后由 QI Tech 关闭。
cancelled由发起参与方取消。

situation_type 枚举​

枚举值描述
scam诈骗或欺诈原因。
account_takeover未经源账户授权的交易原因。
coercion胁迫犯罪原因。
fraudulent_access欺诈性访问源账户原因。
other不适用于上述所列的任何原因。

analysis_result 枚举​

枚举值描述
agreed资金追回被接受，被冻结的资金将被退回。
disagreed资金追回被拒绝，被冻结的资金将被释放。

blocked_balance_status 枚举​

枚举值描述
completelly_blocked与被质疑金额等值的资金已完全冻结。
partially_blocked与被质疑金额等值的资金已部分冻结。正在监控余额。
no_balance账户无余额。正在监控待处理余额。
account_closed账户已关闭。未冻结任何资金。