Skip to main content

单码核销通知

接口用途

  • 用于实现易百券核销成功后将核销状态通知到第三方系统

接口说明

  • 接口异步通知第三方

请求参数,WHALE===>CHANNEL

字段 类型 是否必填 字段意义 备注
requestId String 是 核销流水号 小于64个字符
channelId String 是 通知渠道
ticketId String 是 券ID
ticketName String 是 券名称
thirdActivityId String 是 第三方活动id
code String 是 券号
shopNo String 否 门店编号
shopName String 否 门店名称
verifyRefno String 否 线下核销机具流水号
verifyTime String 是 券核销时间 格式:yyyyMMddHHmmss
verifyType String 是 核销类型

1表示POS机验证; 2表示接口验证;

999 表示不用通知上下游

orderNo String 是 制码订单号
orderItemId String 是 制码子订单号,对接方唯一识别码
discountAmount String 否 核销折抵金额 单位分

请求报文举例

{
    "requestId": "10000000000000000000001",
    "ticketId":"9000000021",
    "ticketName":"汉堡王皇堡/天椒皇堡套餐[bobo测试取码方]",
    "thirdActivityId": "20190226134100",
    "code":"10112504119074937195",
    "shopNo":"1870002",
    "shopName":"家有好面龙阳路店",
    "verifyRefno":"178491000582",
    "verifyTime":"20181016103223",
    "verifyType":"1",
    "orderNo":"a1b626f8b39b4852bfaedc69cc4dbff5",
    "orderItemId":"10191f7aee084db8915dd77293a65906",
    "discountAmount":"2000"
}

返回参数,WHALE===>CHANNEL

字段 类型 是否必填 字段意义 备注
returnCode String 是 请求返回码

09   券码不存在

01   券码已使用

00   券码核销成功

returnMsg String 是 请求返回信息
requestId String 是 原样返回

返回报文举例

{
    "returnCode": "00",
    "returnMsg": "操作成功",
    "requestId": "10000000000000000000001"
}