# message通知

ebuyweb-message消费易百券系统v4.1标准通知，并将通知分发到外部。
易百券系统v4.1标准通知参见：通知 | e-Buy Docs


# 制码通知

## 基本信息

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

## 请求参数


### 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%; height: 89.3907px;"><colgroup><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></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></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Content-Type</td><td style="height: 29.7969px;">application/json</td><td style="height: 29.7969px;">是</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">  
</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: 1593px;"><colgroup><col style="width: 30.9796%;"></col><col style="width: 12.2862%;"></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: 39.7969px;"><td style="height: 39.7969px;"> |\_\_ticketIds</td><td style="height: 39.7969px;">array</td><td style="height: 39.7969px;">是</td><td style="height: 39.7969px;">券批次活动id</td><td style="height: 39.7969px;">  
</td><td style="height: 39.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: 31.375px;"><td style="height: 31.375px;">codeCount</td><td style="height: 31.375px;">number</td><td style="height: 31.375px;">否</td><td style="height: 31.375px;"> </td><td style="height: 31.375px;"> </td><td style="height: 31.375px;"> </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;">最大长度：8</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;"> |\_\_activityId</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;"> |\_\_activityName</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;"> |\_\_brandSalePrice</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;"> |\_\_codeCount</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;"> |\_\_codeDetails</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;"> |\_\_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;"> |\_\_codeH5Url</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;"> |\_\_codeMask</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;"> |\_\_codePicUrl</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;"> |\_\_searchCode</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;"> |\_\_status</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;"> |\_\_statusDesc</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;"> |\_\_useTimes</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;"> |\_\_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;"> |\_\_ecouponType</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;"> |\_\_productId</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;"> |\_\_productName</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;"> |\_\_returnCode</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;"> |\_\_returnMessage</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;"> |\_\_ticketWhaleId</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;"> |\_\_validEnd</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;"> |\_\_validStart</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;"> |\_\_userInfo</td><td style="height: 29.7969px;">object</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;"> |\_\_mobile</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;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_thirdUserId</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;"> |\_\_thirdPlatformType</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;"> |\_\_uuid</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;"> |\_\_orderRemark</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;"> |\_\_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;"> |\_\_saleAppId</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;"> |\_\_saleChannelId</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></tbody></table>

参数请参考（原始参数均来自券系统4.1）：[制码通知 | e-Buy Docs](https://book.e-buy.com/books/e-buy-41/page/a516a)

### 请求示例

```json
{
    "outerOrderId": "20591242205212698112000",
    "userInfo": {

    },
    "channelInfoList": [
        {
            "transferUrl": "https://ups.starbucks.com.cn/***",
            "notifyType": "MakeCode",
            "whaleChannel": false,
            "messageType": "third",
            "channelAppId": "ebuywha102410120",
            "action": "MakeCodeNotify",
            "channelName": "星巴克GC",
            "channelType": "brandChannel",
            "channelId": "674",
            "ticketIds": [
                1000000010882
            ]
        }
    ],
    "codeCount": 1,
    "saleChannelId": 138,
    "appId": "ebuywha102410120",
    "saleAppId": "ebuywha102410120",
    "orderRemark": "{\"trackingNo\":\"COU20210825001\"}",
    "items": [
        {
            "codeCount": 1,
            "productId": 5249,
            "brandSalePrice": -1,
            "validStart": -62170185600000,
            "activityName": "【星巴克GC】 星巴克电子券平台运维-2021第13期",
            "returnMessage": "SUCCESS",
            "thirdSendTicketId": "C0002204",
            "productName": "大杯饮品电子券\t",
            "ticketUseDescription": {
                "useThreshold": "3400"
            },
            "activityId": "503152",
            "returnCode": "00",
            "ecouponType": "exchangeCoupon",
            "outerOrderItemId": "20591242205212698112000",
            "validEnd": -62170185600000,
            "codeDetails": [
                {
                    "code": "1004240520320002019=JN3kEB19",
                    "statusDesc": "未激活",
                    "codeH5Url": "https://w.ebuy.io/lk/dtnGGoWZGf",
                    "codeMask": "100***EB19",
                    "searchCode": "1004240520320002019",
                    "status": "03",
                    "useTimes": 1
                }
            ],
            "ticketId": 1000000010882,
            "ticketWhaleId": "519423_1000000010882",
            "ticketName": "大杯饮品电子券\t"
        }
    ],
    "uuid": "20240520-78293a474547477f97f3f074ebbf8ba8",
    "createDate": 1716206401876
}
```

## 响应

### 响应参数

<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>

# 核销通知

## 基本信息

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

## 请求参数


### 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: 1555.42px;"><colgroup><col style="width: 30.9796%;"></col><col style="width: 12.2862%;"></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;">verifyScene</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">online</td><td style="height: 29.7969px;">核销场景</td><td style="height: 29.7969px;">最大长度：8</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;"> |\_\_brandId</td><td style="height: 29.7969px;">number</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">4339</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;"> |\_\_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;"> |\_\_cashierTransNo</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;"> |\_\_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;"> |\_\_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;"> |\_\_storeInfo</td><td style="height: 29.7969px;">object</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;"> |\_\_cityId</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;"> |\_\_cityName</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;"> |\_\_companyId</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;"> |\_\_companyName</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;"> |\_\_shopName</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;"> |\_\_shopNo</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;"> |\_\_terminalId</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;"> |\_\_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;"> |\_\_userInfo</td><td style="height: 29.7969px;">object</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;"> |\_\_mobile</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;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_thirdUserId</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;"> |\_\_thirdPlatformType</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;"> |\_\_uuid</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;"> |\_\_verifyTime</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></tbody></table>

### 请求示例

```json
{
    "channelInfoList": [
        {
            "notifyType": "Verify",
            "whaleChannel": false,
            "messageType": "ebuy",
            "channelAppId": "402410046",
            "serviceProvider": "",
            "action": "VerifyCodeNotify",
            "channelName": "博时基金",
            "channelType": "saleChannel",
            "channelVersion": "paas",
            "channelId": "ebuywha402410046",
            "ticketIds": [
                1000030005007
            ]
        }
    ],
    "appId": "ebuy1d0c0a81a9a4",
    "verifyScene": "default",
    "items": [
        {
            "userInfo": {

            },
            "cashierTransNo": "ttCN051001320241103002000",
            "code": "10032880473026297020",
            "fineGrainedLimit": {
                "current": 1,
                "limitMaxValue": 1,
                "grainedKey": "total"
            },
            "brandTicketId": "",
            "remainUseTimes": 0,
            "returnCashParam": "{\"paymentParam\":\"{\\\"discountCode\\\":\\\"bankCoupon\\\"}\",\"identifierMap\":\"\"}",
            "printData": "00|兑换产品:CoCo都可20元代金券 X 1|",
            "redeemSerialNum": 1,
            "verifyTime": 1730600279144,
            "uuid": "20241103-b00b98fc29544bae8597098e25c70ff7",
            "outerOrderId": "2410071450574725193200",
            "verifyId": "d0085990ca8c4225a8189780d129d7b7",
            "outerOrderItemId": "2410071450574725193200",
            "brandId": "1458",
            "fundsChannel": {
                "merchantRealAmount": 1500,
                "benefitAmount": 0,
                "merchantCustomBenefit": -1,
                "totalAmount": 2800,
                "merchantCustomRealAmount": -1,
                "channelBenefit": 0,
                "merchantBenefit": 0,
                "discountAmount": 2000,
                "channelCustomBenefit": -1,
                "userRealAmount": 0
            },
            "totalUseTimes": 1,
            "storeInfo": {
                "companyId": "171882",
                "cityName": "连云港",
                "merchantId": "860051827866564",
                "companyName": "连云港创高餐饮管理有限公司巨龙南路店",
                "shopName": "CoCo都可连云港巨龙南路店",
                "cityId": "299",
                "terminalId": "27866564",
                "shopNo": "CN0510013",
                "swift": "0"
            },
            "requestGoods": [
                {
                    "rebateCode": "000",
                    "price": 1500,
                    "qty": 1,
                    "sku": "CNAFIBCAA",
                    "type": "A"
                },
                {
                    "rebateCode": "000",
                    "price": 1300,
                    "qty": 1,
                    "sku": "CNAABLCAA",
                    "type": "A"
                }
            ],
            "ticketId": "1000030005007",
            "ticketName": "易百CoCo20元代金券"
        }
    ],
    "uuid": "20241103-b00b98fc29544bae8597098e25c70ff7",
    "createDate": 1730600279174
}
```

## 响应

### 响应参数

<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>

# 核销撤销通知

## 基本信息

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

## 请求参数


### 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>

# 券码状态变更通知

## 基本信息

券码状态变更通知，易百将券码状态变更通知分发给渠道或者品牌，对接方需提供接口接收通知。

## 请求参数


### 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: 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;">operationType</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;">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;"> |\_\_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;"> |\_\_notifyRequestId</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;"> |\_\_operationType</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;"> |\_\_saleChannelId</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;"> |\_\_saleChannelItemId</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;"> |\_\_saleChannelOrderId</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;"> |\_\_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;"> |\_\_updateDate</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;"> |\_\_updateTime</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
{
    "channelInfoList": [
        {
            "transferUrl": "https://ups.starbucks.com.cn/notifyOnlineLifecycle/cardCoupon/v1/notify/2009",
            "notifyType": "UpdateCodeStatus",
            "whaleChannel": false,
            "messageType": "third",
            "channelAppId": "ebuywha102420017",
            "action": "UpdateCodeStatusNotify",
            "channelName": "星巴克GC",
            "channelType": "brandChannel",
            "channelId": "674",
            "ticketIds": [
                1000030006084
            ]
        },
        {
            "notifyType": "UpdateCodeStatus",
            "whaleChannel": false,
            "messageType": "ebuy",
            "channelAppId": "102420017",
            "serviceProvider": "esb",
            "action": "UpdateCodeStatusNotify",
            "channelName": "抖音本地生活",
            "channelType": "saleChannel",
            "channelVersion": "paas",
            "channelId": "ebuywha102420017",
            "ticketIds": [
                1000030006084
            ]
        }
    ],
    "operationType": "invalid",
    "items": [
        {
            "saleChannelOrderId": "20971301257990133272576",
            "updateDate": "20241103",
            "code": "1004241030700305059=WUhbyTaP",
            "notifyRequestId": "UpdateCodeStatusNotify-20241103-4605c6dbef01463baaec87bbc845db47",
            "saleChannelId": 130,
            "operationType": "invalid",
            "updateTime": "20241103195644",
            "ecouponTicket": {
                "updateDate": 1730184382000,
                "saleChannelId": 130,
                "saleTenancyName": "星巴克GC",
                "codeValidDays": -1,
                "hasTest": "1",
                "uuid": "20241029-E2DbfA4EBA344eaEC1Bd1D2ededC1FDC",
                "ticketValidEnd": 4102415999000,
                "tenancyName": "星巴克GC",
                "updateBy": "周佳明",
                "appId": "ebuy50a485403880",
                "commissionDate": 0,
                "authorityConfig": {
                    "createBy": "周佳明"
                },
                "ticketWhaleId": "677460_1000030006084",
                "createDate": 1729670367000,
                "ticketBindInfo": {
                    "ebuyTicketName": "星巴克太妃榛果系列中杯双杯券DY",
                    "ebuyTicketId": "677460",
                    "thirdSendTicketId": ""
                },
                "brandName": "星巴克GC",
                "paymentParam": {
                    "needBarcode": false,
                    "makeNotify2UserTemplate": "",
                    "paymentParam": "{}",
                    "verifyNotify2UserTemplate": "",
                    "printTemplate": "00|兑换产品:星巴克太妃榛果系列中杯双杯券DY X 1|",
                    "needReturnBuyGoods": false,
                    "returnBuyProduct": "N",
                    "statementCustomer": "易百支付",
                    "projectProductQuotationId": 9842832,
                    "verifyNotifyConf": "00",
                    "onlyAllowOneVerify": "N",
                    "makeNotifyConf": "00",
                    "thirdCodeMap": "",
                    "voidNotifyConf": "00",
                    "statementPrice": "0",
                    "smsMakeNotifySrc": "",
                    "statementCustomerId": "8",
                    "isOverIncome": "0",
                    "smsVerifyNotifySrc": ""
                },
                "codeValidEnd": 1732550399000,
                "codeCount": -1,
                "productId": 9988,
                "brandSalePrice": -1,
                "saleTenancyId": 49,
                "ticketType": "exchangeCoupon",
                "ticketUseDescription": {
                    "useDescription": "",
                    "discountDescription": ""
                },
                "createBy": "周佳明",
                "tenancyId": 49,
                "codeValidStart": 1729612800000,
                "ticketConfig": {
                    "codeRandomType": "string",
                    "waringPerson": [

                    ],
                    "needDynamicCode": false,
                    "defaultRuleGoodsList": "[]",
                    "supportNextDayCancel": "N",
                    "codeRandom": 8,
                    "codePrefix": "",
                    "stepPrice": "N",
                    "needThirdQrcode": false,
                    "needUploadGov": false,
                    "logoUrl": "",
                    "notifyType": "standard",
                    "needEbuyWallet": "N",
                    "waringVal": "",
                    "transparentGoodsDetail": "N",
                    "merchantCustomRealAmount": "Y",
                    "needFilterGoodsDetail": "Y",
                    "needShortLink": false,
                    "logoType": "1",
                    "codeSuffix": "=",
                    "supportSameDayCancel": "Y"
                },
                "brandId": 674,
                "ticketStatus": "0",
                "saleChannelInfo": {
                    "productSource": "",
                    "saleChannelName": "抖音本地生活",
                    "activity": "星巴克-易百券系统运维-LX82022000164",
                    "saleChannelId": 130,
                    "thirdpartySourceId": "610850"
                },
                "ticketValidStart": 1729612800000,
                "remarks": "COU20241022004-04",
                "ticketId": 1000030006084,
                "status": "0",
                "ticketName": "星巴克太妃榛果系列中杯双杯券DY"
            },
            "saleChannelItemId": "20971301257990133272576",
            "ticketId": 1000030006084
        }
    ],
    "uuid": "20241103-4605c6dbef01463baaec87bbc845db47"
}
```

## 响应

### 响应参数

<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>

# 批量激活通知

## 基本信息

批量激活通知，易百将批量激活通知分发给渠道或者品牌，对接方需提供接口接收通知。

## 请求参数


### 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: 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;">operationType</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;">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;"> |\_\_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;"> |\_\_notifyRequestId</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;"> |\_\_operationType</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;"> |\_\_saleChannelId</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;"> |\_\_saleChannelItemId</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;"> |\_\_saleChannelOrderId</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;"> |\_\_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;"> |\_\_updateDate</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;"> |\_\_updateTime</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
{
    "channelInfoList": [
        {
            "action": "UpdateCodeStatusNotify",
            "channelId": "671",
            "ticketIds": [
                1000030002158
            ],
            "notifyType": "UpdateCodeStatus",
            "channelName": "歌帝梵",
            "channelType": "brandChannel",
            "transferUrl": "none",
            "channelAppId": "ebuy0197933d568c",
            "whaleChannel": false
        }
    ],
    "uuid": "20230722-d64fa1b6de634f3580f17e3105612ceb",
    "items": [
        {
            "code": "R23900110032813492114610230",
            "ticketId": 1000030002158,
            "updateDate": "20230630",
            "updateTime": "20230630112126",
            "activateInfo": {
                "optShopNo": "1007",
                "optShopName": "歌帝梵上海五角场万达店"
            },
            "ecouponTicket": {
                "uuid": "20230630-0ce6404162754e2ea686e01c17c11d67",
                "appId": "ebuy0197933d568c",
                "status": "0",
                "brandId": 671,
                "hasTest": "1",
                "createBy": "歌帝梵",
                "ticketId": 1000030002158,
                "updateBy": "纪永",
                "brandName": "歌帝梵",
                "codeCount": -1,
                "productId": 4625,
                "tenancyId": 28,
                "createDate": 1688093861000,
                "ticketName": "鎏金明悦礼盒",
                "ticketType": "orderVoucher",
                "updateDate": 1688106752000,
                "tenancyName": "歌帝梵",
                "codeValidEnd": 1786291199000,
                "paymentParam": {
                    "needBarcode": false,
                    "makeNotifyConf": "00",
                    "voidNotifyConf": "00",
                    "needReturnBuyGoods": true
                },
                "ticketConfig": {
                    "codePrefix": "R239001",
                    "notifyType": "standard",
                    "needShortLink": true,
                    "needUploadGov": false,
                    "needDynamicCode": false,
                    "needThirdQrcode": false,
                    "supportNextDayCancel": "Y",
                    "needFilterGoodsDetail": "Y",
                    "checkActivityProductRepeat": false
                },
                "codeValidDays": -1,
                "saleChannelId": 94,
                "saleTenancyId": 28,
                "ticketWhaleId": "622935_1000030002158",
                "codeValidStart": 1691596800000,
                "commissionDate": 0,
                "ticketBindInfo": {
                    "ebuyTicketId": "622935"
                },
                "ticketValidEnd": 1696089599000,
                "saleChannelInfo": {
                    "activity": "鎏金明悦礼盒",
                    "saleChannelId": 94,
                    "saleChannelName": "歌帝梵"
                },
                "saleTenancyName": "歌帝梵",
                "ticketValidStart": 1685548800000
            },
            "operationType": "activate",
            "saleChannelId": 94,
            "notifyRequestId": "batchActivateCodeNotify-20230722-d64fa1b6de634f3580f17e3105612ceb",
            "saleChannelItemId": "o23063011204485539127",
            "saleChannelOrderId": "o23063011204483833158"
        }
    ],
    "operationType": "activate"
}
```

## 响应

### 响应参数

<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>

# 批量取消激活通知

## 基本信息

批量取消激活通知，易百将批量取消激活通知分发给渠道或者品牌，对接方需提供接口接收通知。

## 请求参数


### 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: 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;">operationType</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;">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;"> |\_\_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;"> |\_\_notifyRequestId</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;"> |\_\_operationType</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;"> |\_\_saleChannelId</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;"> |\_\_saleChannelItemId</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;"> |\_\_saleChannelOrderId</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;"> |\_\_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;"> |\_\_updateDate</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;"> |\_\_updateTime</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
{
    "channelInfoList": [
        {
            "action": "UpdateCodeStatusNotify",
            "channelId": "671",
            "ticketIds": [
                1000030002160
            ],
            "notifyType": "UpdateCodeStatus",
            "channelName": "歌帝梵",
            "channelType": "brandChannel",
            "transferUrl": "none",
            "channelAppId": "ebuy0197933d568c",
            "whaleChannel": false
        }
    ],
    "uuid": "20230724-95e72fb721dc4d42891ff9bf951a0d61",
    "items": [
        {
            "code": "R23900310032813490810348736",
            "ticketId": 1000030002160,
            "updateDate": "20230724",
            "updateTime": "20230724202516",
            "ecouponTicket": {
                "uuid": "20230630-64908b2c33344cb3b0750e92abd93486",
                "appId": "ebuy0197933d568c",
                "status": "0",
                "brandId": 671,
                "hasTest": "1",
                "createBy": "歌帝梵",
                "ticketId": 1000030002160,
                "updateBy": "纪永",
                "brandName": "歌帝梵",
                "codeCount": -1,
                "productId": 4627,
                "tenancyId": 28,
                "createDate": 1688093997000,
                "ticketName": "奢金非梵礼盒",
                "ticketType": "orderVoucher",
                "updateDate": 1688106698000,
                "tenancyName": "歌帝梵",
                "codeValidEnd": 1786291199000,
                "paymentParam": {
                    "needBarcode": false,
                    "makeNotifyConf": "00",
                    "voidNotifyConf": "00",
                    "needReturnBuyGoods": true
                },
                "ticketConfig": {
                    "codePrefix": "R239003",
                    "notifyType": "standard",
                    "needShortLink": true,
                    "needUploadGov": false,
                    "needDynamicCode": false,
                    "needThirdQrcode": false,
                    "supportNextDayCancel": "Y",
                    "needFilterGoodsDetail": "Y",
                    "checkActivityProductRepeat": false
                },
                "codeValidDays": -1,
                "saleChannelId": 94,
                "saleTenancyId": 28,
                "ticketWhaleId": "622945_1000030002160",
                "codeValidStart": 1689955200000,
                "commissionDate": 0,
                "ticketBindInfo": {
                    "ebuyTicketId": "622945"
                },
                "ticketValidEnd": 1696089599000,
                "saleChannelInfo": {
                    "activity": "奢金团员礼盒",
                    "saleChannelId": 94,
                    "saleChannelName": "歌帝梵"
                },
                "saleTenancyName": "歌帝梵",
                "ticketValidStart": 1685548800000
            },
            "operationType": "unActivate",
            "saleChannelId": 94,
            "notifyRequestId": "batchUnActivateCodeNotify-20230724-95e72fb721dc4d42891ff9bf951a0d61",
            "saleChannelItemId": "o23063011081480119088",
            "saleChannelOrderId": "o23063011081476782265"
        }
    ],
    "operationType": "unActivate"
}
```

## 响应

### 响应参数

<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>