券码状态变更通知

基本信息

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

请求参数

Headers

参数名称	参数值	是否必填
Content-Type	application/json	是

Body

参数名称	类型	必填	默认值	备注	其他信息
channelInfoList	array	是	通知渠道列表
|__action	string	是	VerifyCodeNotify	通知action	最大长度：24 最小长度：1
|__channelAppId	string	是	ebuy19915d0498cf	通知渠道appId	最大长度：24 最小长度：1
|__channelId	string	是	ebuywha102410004	通知渠道id	最大长度：24 最小长度：1
|__channelName	string	是	易百演示	通知渠道名称	最大长度：16 最小长度：1
|__channelType	string	是	saleChannel	通知渠道类型	最大长度：12 最小长度：1
|__messageType	string	是	ebuy	通知消息格式	最大长度：12 最小长度：1
|__notifyType	string	是	Verify	通知消息类型	最大长度：12 最小长度：1
|__ticketIds	array	是	券批次活动id
|__transferUrl	string	否	通知渠道三方地址		最大长度：255 最小长度：1
uuid	string	是	20220509-b485a27c80914357912b029a8a8f5f9b	请求uuid	最大长度：40 最小长度：1
operationType	string	否
items	array	否
|__code	string	否		券码
|__notifyRequestId	string	否		券码核销请求uuid
|__operationType	string	否		操作类型
|__saleChannelId	string	否		销售渠道ID
|__saleChannelItemId	string	否
|__saleChannelOrderId	string	否		销售渠道订单ID
|__ticketId	string	否		券批次id
|__updateDate	string	否
|__updateTime	number	否

请求示例

{
    "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"
}

响应

响应参数

参数名称	类型	必填	默认值	备注	其他信息
code	string	是		响应码
message	string	否		响应消息

响应示例

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

注意：

响应码不为EB_SUCCESS 或 EB_FAIL 易百将会进行重试，请保证接口幂等性。

• {"code":"EB_SUCCESS","message":"操作成功"}  // 业务处理成功，不重试
  
• {"code":"EB_FAIL","message":"操作失败"}  // 业务处理失败，不重试
  
• 其他未知失败   // 重试