Skip to main content

核销撤销通知

基本信息

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

请求参数

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
verifyScenecreateDate stringnumber 是否 online  核销场景通知时间 最大长度：8 
items array 是否


    |__brandIdnumber是4339品牌id
    |__brandTicketId string 是否
品牌活动产品id
    |__cashierTransNo__code string 是否
收银机流水号券码
    |__code__originalRequestId string 是否
券码核销券码请求uuid
    |__outerOrderId string 是否
外部制码订单号
    |__outerOrderItemId string 是否
外部制码子订单号
    |__storeInfoobject是
核销上送门店信息
        |__cityIdstring是
城市id
        |__cityNamestring是
城市名称
        |__companyIdstring是
公司id
        |__companyNamestring是
工司名称
        |__shopNamestring是
门店名称
        |__shopNostring是
门店编号
        |__terminalIdstring是
核销终端id
    |__ticketId string 是否
券批次id
    |__ticketName string 是否
券批次名称
    |__userInfo__verifyDate objectnumber 是
制码用户信息
        |__mobilestring是
制码上送用户手机号
        |__thirdUserIdstring是
制码上送用户id
        |__thirdPlatformTypestring是
上送平台类型
    |__uuidstring是


    |__verifyTimestring是否
核销时间

请求示例

{
    "channelInfoList": [
        {
            "notifyType"uuid": "Verify",
            "whaleChannel": false,
            "messageType": "ebuy",
            "channelAppId": "402410046",
            "serviceProvider": "",
            "action": "VerifyCodeNotify",
            "channelName": "博时基金",
            "channelType": "saleChannel",
            "channelVersion": "paas",
            "channelId": "ebuywha402410046",
            "ticketIds": [
                1000030005007
            ]
        }
    ]20240517-ce26ddc2839e49afb004976179b3c299",
    "appId": "ebuy1d0c0a81a9a4",
    "verifyScene": "default",
    "items": [
        {
            "userInfo": {

            },
            "cashierTransNo": "ttCN051001320241103002000",
            "code": "10032880473026297020"1004231231260035262=7sU8TPTD",
            "fineGrainedLimit"ticketId": {"1000000010748",
            "current"verifyId": "36d61fc75def4228bdc1bd4505fd5fcd",
            "codeCount": 1,
            "limitMaxValue": 1,
                "grainedKey"ticketName": "total"星巴克中杯饮品券",
            }"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": "",
            "remainUseTimes": 0,
            "returnCashParam"outerOrderItemId": "{\"paymentParam\":\"{\\\"discountCode\\\":\\\"bankCoupon\\\"}\",\"identifierMap\":\"\"}"20521190871607460888576",
            "printData": "00|兑换产品:CoCo都可20元代金券 X 1|",
            "redeemSerialNum"thisCodeQuantity": 1,
            "verifyTime": 1730600279144,
            "uuid"originalRequestId": "20241103-b00b98fc29544bae8597098e25c70ff7"36d61fc75def4228bdc1bd4505fd5fcd",
            "outerOrderId"thirdSendTicketId": "2410071450574725193200"C0002157",
            "verifyId"originalCashierTransNo": "d0085990ca8c4225a8189780d129d7b7"52622405178100030544"
        }
    ],
    "outerOrderItemId"createDate": "2410071450574725193200",1715942820438,
    "brandId": "1458",
            "fundsChannel": {
                "merchantRealAmount": 1500,
                "benefitAmount": 0,
                "merchantCustomBenefit": -1,
                "totalAmount": 2800,
                "merchantCustomRealAmount": -1,
                "channelBenefit": 0,
                "merchantBenefit": 0,
                "discountAmount": 2000,
                "channelCustomBenefit": -1,
                "userRealAmount": 0
            },
            "totalUseTimes": 1,
            "storeInfo": {
                "companyId": "171882",
                "cityName": "连云港",
                "merchantId": "860051827866564",
                "companyName": "连云港创高餐饮管理有限公司巨龙南路店",
                "shopName": "CoCo都可连云港巨龙南路店",
                "cityId": "299",
                "terminalId": "27866564",
                "shopNo": "CN0510013",
                "swift": "0"
            },
            "requestGoods"channelInfoList": [
        {
            "rebateCode"action": "000"VerifyCodeNotify",
            "price": 1500,
                    "qty": 1,
                    "sku"channelId": "CNAFIBCAA"674",
            "type"ticketIds": "A"[
                },
                {
                    "rebateCode": "000",
                    "price": 1300,
                    "qty": 1,
                    "sku": "CNAABLCAA",
                    "type": "A"
                }1000000010748
            ],
            "ticketId"notifyType": "1000030005007"VerifyVoid",
            "ticketName"channelName": "易百CoCo20元代金券星巴克GC",
            "channelType": "brandChannel",
            "messageType": "third",
            "transferUrl": "https://ups.starbucks.com.cn/notifyOnlineLifecycle/cardCoupon/v1/notify/2009",
            "channelAppId": "ebuywha102410114",
            "whaleChannel": false
        }
    ],
    "uuid": "20241103-b00b98fc29544bae8597098e25c70ff7",
    "createDate": 1730600279174
}

响应

响应参数

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

响应示例

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

注意：

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

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


Back to top