Webhook

Webhook 是接口在发生与 MED 相关的事件时自动发出的通知。 这样您无需反复轮询接口：事件到达时接收并处理即可。

Webhook 事件

每个 webhook 都代表 MED 生命周期中的一次变化。

事件类型

事件	说明
MED_CREATED	MED 已创建
MED_CLOSED	MED 已关闭
MED_APPEALED	已提交 MED 申诉
MED_APPROVED	MED 已通过
MED_REJECTED	MED 已驳回

Webhook 数据

字段	类型	必填	说明
type	string (enum) - MED_CREATED, MED_CLOSED, MED_APPEALED, MED_APPROVED, MED_REJECTED	是	事件类型
data	object	是	MED 数据（参见子对象 data）

子对象

data

字段	类型	必填	说明
id	string (UUID)	是	交易的唯一标识
amount	number	是	交易金额（整数，以分为单位）
externalCode	string	否	您的参考编号
createdAt	string (ISO)	是	创建时间
status	string (enum) - BLOCKED, PAID, PROCESSING_INFRACTION, INFRACTION	是	BLOCKED：交易因 MED 被冻结 PAID：交易已释放 PROCESSING_INFRACTION：违规处理中 INFRACTION：违规已确认
endToEnd	string	否	交易的 end-to-end 标识
med	object	是	MED 数据（参见子对象 Med）

Med

字段	类型	必填	说明
id	string (UUID)	是	MED 的唯一标识
createdAt	string (ISO)	是	创建时间
status	string (enum) - PENDING, APPEALED, APPROVED, REJECTED	是	MED 的状态

payload 示例

{
  "type": "MED_CREATED",
  "data": {
    "id": "553e8400-e29b-41d4-a716-436251480000",
    "amount": 10000,
    "externalCode": "TRANS-123",
    "createdAt": "2026-03-06T12:49:04.681Z",
    "status": "BLOCKED",
    "endToEnd": "E2E123456789",
    "med": {
      "id": "993e8400-e29b-41d4-a716-436251480001",
      "createdAt": "2026-03-06T12:49:04.681Z",
      "status": "PENDING"
    }
  }
}