Webhooks
MedCreated
概览
MedCreated 事件会在一笔新的 MED(特殊退款机制) 被登记,针对您账户接收的某笔 PIX 交易时发送。这表示付款人银行正在请求退回该金额。
此事件需要立即关注。MED 具有由巴西中央银行规定的监管期限,须在期限内完成分析和响应。
| 字段 | 值 |
|---|---|
event | MedCreated |
| 含义 | 新的 MED 已开启 — 已收到退款请求 |
| 建议操作 | 通知风险团队,评估原始交易 |
完整 Payload
{
"event": "MedCreated",
"medId": 42,
"idSolicitacaoDevolucao": "MED-2026041012345",
"endToEndId": "E12345678202604101030abcdef123456",
"status": "RECEIVED",
"reason": "REFUND_REQUEST",
"cause": "UNAUTHORIZED_TRANSACTION",
"description": "Customer claims not to have performed the transaction",
"analysisResult": null,
"analysisDetails": null,
"originalTransaction": {
"transactionId": 78432,
"amount": 1500.00,
"endToEndId": "E12345678202604101030abcdef123456",
"externalId": "ORDER-78432"
},
"blockStatus": null,
"blockedAmount": null,
"defenseStatus": null,
"requestingBank": {
"ispb": "00000000",
"name": "BCO DO BRASIL S.A."
},
"contestedBank": {
"ispb": "13140088",
"name": "ACESSO SOLUÇÕES DE PAGAMENTO"
},
"statusHistory": [
{ "status": "OPEN", "date": "2026-04-10T09:55:12.000Z" },
{ "status": "RECEIVED", "date": "2026-04-10T10:00:00.000Z" }
],
"createdAt": "2026-04-10T10:00:00.000Z",
"updatedAt": "2026-04-10T10:00:00.000Z"
}字段
| 字段 | 类型 | 描述 |
|---|---|---|
event | string | 事件类型: "MedCreated" |
medId | number | 系统中 MED 的唯一标识 |
idSolicitacaoDevolucao | string | 退款请求的唯一标识 |
endToEndId | string | 原始 PIX 交易的 end-to-end ID |
status | string | 当前状态: "RECEIVED" |
reason | string | 原因: "REFUND_REQUEST" 或 "REFUND_CANCELLATION" |
cause | string | null | 可用时的原因代码(UNAUTHORIZED_TRANSACTION、FRAUDULENT_ACCESS、SOCIAL_ENGINEERING、OPERATIONAL_FAILURE),否则为 null。若为 null,请参阅 description。 |
description | string | null | 描述性文本(付款人陈述、银行正式通知等) |
analysisResult | string | null | 分析结果(此阶段为 null) |
analysisDetails | string | null | 分析详情(此阶段为 null) |
originalTransaction | object | null | 原始 PIX 交易的数据(如已对账) |
originalTransaction.transactionId | number | 平台内部交易 ID |
originalTransaction.amount | number | 原始金额(BRL) |
originalTransaction.endToEndId | string | 原始交易的 E2E ID |
originalTransaction.externalId | string | null | 您在创建交易时提供的外部 ID |
blockStatus | string | null | 余额锁定状态: null、"BLOCKED"、"UNBLOCKED"、"APPROVED" |
blockedAmount | number | null | 锁定金额(BRL) |
defenseStatus | string | null | 申辩状态: null、"PENDING"、"SUBMITTED" |
requestingBank | object | 开启 MED 的银行(付款人银行) |
requestingBank.ispb | string | 请求银行的 ISPB 代码 |
requestingBank.name | string | 请求银行名称 |
contestedBank | object | 被申请银行(贵机构) |
contestedBank.ispb | string | 被申请银行的 ISPB 代码 |
contestedBank.name | string | 被申请银行名称 |
statusHistory | array | MED 状态变更历史 |
statusHistory[].status | string | 该时刻的状态(取值同 status) |
statusHistory[].date | string | 变更日期(ISO 8601) |
createdAt | string | MED 创建日期(ISO 8601) |
updatedAt | string | 最后更新日期(ISO 8601) |