Skip to main content

单码核销

接口用途

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

接口说明

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

action

  • CodeVerify

请求参数，CHANNEL===>WHALE

字段类型是否必填字段意义备注
verifySceneString是交易场景.offline线下,online线上 
codeString是码号 
isProductCheckString是是否校验订单产品规则是Y，否N
requestIdString是请求流水号确保永久唯一性32位长度
refNoString否系统参考号12位长度
cashierTransNoString否收银机流水号最长64位长度
requestIdString是请求流水号确保永久唯一性32位长度
storeInfoObject<storeInfo>否门店核销时上送，组合劵必填 
cashTotalAmountNumber否订单总金额（收银机总金额也是用此字段）单位：分
goodsDetailList<goodsDetail>否(只有在收银POS上发起交易时才上送)

请求报文举例

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

字段类型是否必填字段意义备注
returnCodeString是请求返回码返回码32时，请调用单码核销查询接口CodeVerifyQuery，确认核销结果
returnMsgString是请求返回信息 
dataObject<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|"
    }
}
Back to top