单码核销
接口用途
- 券码进行核销时，调用此接口
接口说明
- 一次只能对一个码进行核销。
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|"
}
}