券码状态变更通知

基本信息 

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

 

 请求参数 

 

 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":"操作失败"}  // 业务处理失败，不重试 

 其他未知失败   // 重试