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"
}