# 券码状态变更通知

## 基本信息

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

## 请求参数


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