核销撤销通知

基本信息 

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

 

 请求参数 

 

 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 

 appId 

 string 

 否 

 

 请求appid 

 

 uuid 

 string 

 是 

 20220509-b485a27c80914357912b029a8a8f5f9b 

 请求uuid 

 最大长度：40 最小长度：1 

 createDate 

 number 

 否 

   

 通知时间 

   

 items 

 array 

 否 

 

 

 

     |__brandTicketId 

 string 

 否 

 

 品牌活动产品id 

 

     |__code 

 string 

 否 

 

 券码 

 

     |__originalRequestId 

 string 

 否 

 

 券码核销请求uuid 

 

     |__outerOrderId 

 string 

 否 

 

 外部制码订单号 

 

     |__outerOrderItemId 

 string 

 否 

 

 外部制码子订单号 

 

     |__ticketId 

 string 

 否 

 

 券批次id 

 

     |__ticketName 

 string 

 否 

 

 券批次名称 

 

     |__verifyDate 

 number 

 否 

 

 核销时间 

 

 

 请求示例 

 {

 "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

 }

 ]

} 

 

 响应 

 响应参数 

 参数名称 

 类型 

 必填 

 默认值 

 备注 

 其他信息 

 code 

 string 

 是 

 

 响应码 

 

 message 

 string 

 否 

 

 响应消息 

 

 

 响应示例 

 

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

 注意： 

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

 {"code":"EB_SUCCESS","message":"操作成功"}  // 业务处理成功，不重试 

 {"code":"EB_FAIL","message":"操作失败"}  // 业务处理失败，不重试 

 其他未知失败   // 重试