# 核销撤销通知

## 基本信息

核销撤销通知，易百将核销撤销通知分发给渠道或者品牌，对接方需提供接口接收通知。

## 请求参数


### Headers

<table border="1" id="bkmrk-%E5%8F%82%E6%95%B0%E5%90%8D%E7%A7%B0-%E5%8F%82%E6%95%B0%E5%80%BC-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-conten" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col></colgroup><tbody><tr><td>参数名称</td><td>参数值</td><td>是否必填</td></tr><tr><td>Content-Type</td><td>application/json</td><td>是</td></tr><tr><td>  
</td><td>  
</td><td>  
</td></tr></tbody></table>

### Body

<table border="1" id="bkmrk-%E5%8F%82%E6%95%B0%E5%90%8D%E7%A7%B0-%E7%B1%BB%E5%9E%8B-%E5%BF%85%E5%A1%AB-%E9%BB%98%E8%AE%A4%E5%80%BC-%E5%A4%87%E6%B3%A8-%E5%85%B6%E4%BB%96" style="border-collapse: collapse; width: 100%; height: 853.298px;"><colgroup><col style="width: 30.9893%;"></col><col style="width: 12.2765%;"></col><col style="width: 6.7938%;"></col><col style="width: 16.6865%;"></col><col style="width: 16.6865%;"></col><col style="width: 16.6865%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">参数名称</td><td style="height: 29.7969px;">类型</td><td style="height: 29.7969px;">必填</td><td style="height: 29.7969px;">默认值</td><td style="height: 29.7969px;">备注</td><td style="height: 29.7969px;">其他信息</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">channelInfoList</td><td style="height: 29.7969px;">array</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">通知渠道列表</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;"> |\_\_action</td><td style="height: 46.5938px;">string</td><td style="height: 46.5938px;">是</td><td style="height: 46.5938px;">VerifyCodeNotify</td><td style="height: 46.5938px;">通知action</td><td style="height: 46.5938px;">最大长度：24  
最小长度：1</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;"> |\_\_channelAppId</td><td style="height: 46.5938px;">string</td><td style="height: 46.5938px;">是</td><td style="height: 46.5938px;">ebuy19915d0498cf</td><td style="height: 46.5938px;">通知渠道appId</td><td style="height: 46.5938px;">最大长度：24  
最小长度：1</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;"> |\_\_channelId</td><td style="height: 46.5938px;">string</td><td style="height: 46.5938px;">是</td><td style="height: 46.5938px;">ebuywha102410004</td><td style="height: 46.5938px;">通知渠道id</td><td style="height: 46.5938px;">最大长度：24  
最小长度：1</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;"> |\_\_channelName</td><td style="height: 46.5938px;">string</td><td style="height: 46.5938px;">是</td><td style="height: 46.5938px;">易百演示</td><td style="height: 46.5938px;">通知渠道名称</td><td style="height: 46.5938px;">最大长度：16  
最小长度：1</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;"> |\_\_channelType</td><td style="height: 46.5938px;">string</td><td style="height: 46.5938px;">是</td><td style="height: 46.5938px;">saleChannel</td><td style="height: 46.5938px;">通知渠道类型</td><td style="height: 46.5938px;">最大长度：12  
最小长度：1</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;"> |\_\_messageType</td><td style="height: 46.5938px;">string</td><td style="height: 46.5938px;">是</td><td style="height: 46.5938px;">ebuy</td><td style="height: 46.5938px;">通知消息格式</td><td style="height: 46.5938px;">最大长度：12  
最小长度：1</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;"> |\_\_notifyType</td><td style="height: 46.5938px;">string</td><td style="height: 46.5938px;">是</td><td style="height: 46.5938px;">Verify</td><td style="height: 46.5938px;">通知消息类型</td><td style="height: 46.5938px;">最大长度：12  
最小长度：1</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_ticketIds</td><td style="height: 29.7969px;">array</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">券批次活动id</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;"> |\_\_transferUrl</td><td style="height: 46.5938px;">string</td><td style="height: 46.5938px;">否</td><td style="height: 46.5938px;">通知渠道三方地址</td><td style="height: 46.5938px;">  
</td><td style="height: 46.5938px;">最大长度：255  
最小长度：1</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">appId</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">否</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">请求appid</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 63.3906px;"><td style="height: 63.3906px;">uuid</td><td style="height: 63.3906px;">string</td><td style="height: 63.3906px;">是</td><td style="height: 63.3906px;">20220509-b485a27c80914357912b029a8a8f5f9b</td><td style="height: 63.3906px;">请求uuid</td><td style="height: 63.3906px;">最大长度：40  
最小长度：1</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">createDate</td><td style="height: 29.7969px;">number</td><td style="height: 29.7969px;">否</td><td style="height: 29.7969px;"> </td><td style="height: 29.7969px;">通知时间</td><td style="height: 29.7969px;"> </td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">items</td><td style="height: 29.7969px;">array</td><td style="height: 29.7969px;">否</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_brandTicketId</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">否</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">品牌活动产品id</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_code</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">否</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">券码</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_originalRequestId</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">否</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">券码核销请求uuid</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_outerOrderId</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">否</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">外部制码订单号</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_outerOrderItemId</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">否</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">外部制码子订单号</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_ticketId</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">否</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">券批次id</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_ticketName</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">否</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">券批次名称</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_verifyDate</td><td style="height: 29.7969px;">number</td><td style="height: 29.7969px;">否</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">核销时间</td><td style="height: 29.7969px;">  
</td></tr></tbody></table>

### 请求示例

```json
{
    "uuid": "20240517-ce26ddc2839e49afb004976179b3c299",
    "appId": "ebuy1d0c0a81a9a4",
    "items": [
        {
            "code": "1004231231260035262=7sU8TPTD",
            "ticketId": "1000000010748",
            "verifyId": "36d61fc75def4228bdc1bd4505fd5fcd",
            "codeCount": 1,
            "ticketName": "星巴克中杯饮品券",
            "verifyDate": 1715942792000,
            "fundsChannel": "{\"benefitAmount\":0,\"channelBenefit\":0,\"discountAmount\":0.00,\"merchantBenefit\":0,\"merchantCustomBenefit\":-1,\"merchantCustomRealAmount\":-1,\"merchantRealAmount\":0,\"totalAmount\":0,\"userRealAmount\":0}",
            "outerOrderId": "20521190871607460888576",
            "brandTicketId": "",
            "outerOrderItemId": "20521190871607460888576",
            "thisCodeQuantity": 1,
            "originalRequestId": "36d61fc75def4228bdc1bd4505fd5fcd",
            "thirdSendTicketId": "C0002157",
            "originalCashierTransNo": "52622405178100030544"
        }
    ],
    "createDate": 1715942820438,
    "channelInfoList": [
        {
            "action": "VerifyCodeNotify",
            "channelId": "674",
            "ticketIds": [
                1000000010748
            ],
            "notifyType": "VerifyVoid",
            "channelName": "星巴克GC",
            "channelType": "brandChannel",
            "messageType": "third",
            "transferUrl": "https://ups.starbucks.com.cn/notifyOnlineLifecycle/cardCoupon/v1/notify/2009",
            "channelAppId": "ebuywha102410114",
            "whaleChannel": false
        }
    ]
}
```

## 响应

### 响应参数

<table border="1" id="bkmrk-%E5%8F%82%E6%95%B0%E5%90%8D%E7%A7%B0-%E7%B1%BB%E5%9E%8B-%E5%BF%85%E5%A1%AB-%E9%BB%98%E8%AE%A4%E5%80%BC-%E5%A4%87%E6%B3%A8-%E5%85%B6%E4%BB%96-1" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 16.6667%;"></col><col style="width: 16.6667%;"></col><col style="width: 16.6667%;"></col><col style="width: 16.6667%;"></col><col style="width: 16.6667%;"></col><col style="width: 16.6667%;"></col></colgroup><tbody><tr><td>参数名称</td><td>类型</td><td>必填</td><td>默认值</td><td>备注</td><td>其他信息</td></tr><tr><td>code</td><td>string</td><td>是</td><td>  
</td><td>响应码</td><td>  
</td></tr><tr><td>message</td><td>string</td><td>否</td><td>  
</td><td>响应消息</td><td>  
</td></tr></tbody></table>

### 响应示例

```json
{"code":"EB_SUCCESS","message":"操作成功"}
```

注意：

响应码不为<span style="background-color: rgb(251, 238, 184);">EB\_SUCCESS 或 <span style="background-color: rgb(251, 238, 184);">EB\_FAIL</span></span> 易百将会进行重试，请保证接口幂等性。

- <span style="background-color: rgb(251, 238, 184);">{"code":"EB\_SUCCESS","message":"操作成功"} // 业务处理成功，不重试</span>
- <span style="background-color: rgb(251, 238, 184);">{"code":"EB\_FAIL","message":"操作失败"} // 业务处理失败，不重试</span>
- <span style="background-color: rgb(251, 238, 184);">其他未知失败 // 重试</span>