核销撤销通知

基本信息

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

请求参数

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