单码核销

接口用途 

 券码进行核销时，调用此接口 

 接口说明 

 一次只能对一个码进行核销。 

 action 

 CodeVerify 

 请求参数，CHANNEL===> WHALE 

 字段 

 类型 

 是否必填 

 字段意义 

 备注 

 verifyScene 

 String 

 是 

 交易场景.offline线下,online线上 

   

 code 

 String 

 是 

 码号 

   

 isProductCheck 

 String 

 是 

 是否校验订单产品规则 

 是Y，否N 

 requestId 

 String 

 是 

 请求流水号确保永久唯一性 

 32位长度 

 refNo 

 String 

 否 

 系统参考号 

 12位长度 

 cashierTransNo 

 String 

 否 

 收银机流水号 

 最长64位长度 

 requestId 

 String 

 是 

 请求流水号确保永久唯一性 

 32位长度 

 storeInfo 

 Object< storeInfo > 

 否 

 门店核销时上送，组合劵必填 

   

 cashTotalAmount 

 Number 

 否 

 订单总金额（收银机总金额也是用此字段） 

 单位：分 

 goodsDetail 

 List< goodsDetail > 

 否 

 (只有在收银POS上发起交易时才上送) 

   

 remark 

 String 

 否 

 备注（在核销撤销、核销查询等接口原样返回） 

   

 请求报文举例 

 {

 "verifyScene":"offline",

 "code": "10215523190570712621",

 "requestId": "20181019112535100000000000000001",

 "refNo": "181215430700",

 "cashierTransNo": "42441908138100007498001",

 "storeInfo": {

 "cityId":"1012",

 "swift": "00105",

 "tid": "99000014",

 "mid": "99000013341001",

 "shopNo": "C00001",

 "storeName": "上海浦东测试门店",

 "manageCompany": "上海浦东测试店管理公司",

 "companyId": "218"

 },

 "cashTotalAmount": "20000",

 "goodsDetail": [{

 "sku": "1112343",

 "qty": 1,

 "price": 3000,

 "type": "03",

 "spec": "03"

 }, {

 "sku": "1212342",

 "qty": 1,

 "price": 3500,

 "type": "03",

 "spec": "03"

 }]

}

 

 返回参数， WHALE ===>CHANNEL 

 字段 

 类型 

 是否必填 

 字段意义 

 备注 

 returnCode 

 String 

 是 

 请求返回码 

 返回码32时，请调用单码核销查询接口CodeVerifyQuery，确认核销结果 

 returnMsg 

 String 

 是 

 请求返回信息 

   

 data 

 Object< data > 

 是 

 券码核销订单明细返回 

 返回报文举例 

 {

 "returnCode": "00",

 "returnMsg": "操作成功",

 "requestId": "10000000000000000000002",

 "data": {

 "cashTotalAmount": 17800,

 "faceValue": 50000,

 "fundsChannel": {

 "totalAmount": 50000,

 "discountAmount": 50000,

 "merchantRealAmount": 40000,

 "channelBenefit": 10000,

 "merchantBenefit": 10000,

 "userRealAmount": 30000

 },

 "goodsDetail": [{

 "sku": "1212342",

 "qty": 1,

 "price": 3500,

 "type": "03",

 "spec": "03"

 }],

 "code": "10215523190570712621",

 "ticketId": "3",

 "ticketName": "50 元现金抵价券 ",

 "activityNo": "2017071951",

 "activityName": "联动优势电子凭证",

 "thirdActivityId": "20190226134100",

 "returnCashParam":{

 "tenderCode":"132"

 },

 "printData": "00|产品：测试券|00|团购价：100|00|订单号：100000000002100002|00|兑换码：101105********4289|"

 }

}