Alert Notification

本接口用于通知商户差错告警（Dispute Alert）事件。差错告警是持卡人向发卡行报告欺诈或对交易提出争议时，由 Ethoca 推送的预警。

通知发送到与 Notification 接口相同的异步通知地址，eventCode = Dispute；可通过 disputeInfo.disputeType = Dispute Alert 区分差错告警通知与退单通知。

通知事件（disputeInfo.status）

status	发送时机
received	已收到告警，并已匹配到商户门店
refunded	EVO Payment 已自动对原交易全额退款
manual_pending	该告警不做自动退款，请商户自行对原交易手工退款

需要商户手工退款的告警，不会再发送 refunded 通知。

同一笔告警的各次通知 caseNo 相同，可用 caseNo + status 去重。

收到通知后请返回 SUCCESS。

请求参数

Body 参数application/json

示例

已收到告警已自动退款需商户手工退款

status=received。此时尚未识别原交易，不返回 merchantTransInfo

{
    "eventCode": "Dispute",
    "disputeInfo": {
        "caseNo": "6aaa55e7f119cec494aea4bb",
        "disputeMode": "DISPUTE_NOTIFICATION",
        "disputeType": "Dispute Alert",
        "alertType": "Customer Dispute",
        "status": "received",
        "recordTime": "2026-09-16T16:49:59+08:00",
        "disputeAmount": {
            "currency": "HKD",
            "value": "50.00"
        },
        "ARN": "74831473302000010165045",
        "remarks": "TENCENT MIDASBUY"
    },
    "storeInfo": {
        "storeID": "S024116",
        "storeName": "Tencent_midasbuy_MPE"
    },
    "transAmount": {
        "currency": "HKD",
        "value": "50.00"
    }
}

请求参数

返回响应