Skip to main content

批量码核销

接口用途

  • 多码批量核销时，调用此接口

接口说明

  • 一次可以多码核销,一次最多10个码。

action

  • BatchCodesVerify

请求参数，CHANNEL===>WHALE

字段类型是否必填字段意义备注
verifySceneString是交易场景.offline线下,online线上线上也可以传抖音、美团等
codesList是码号数组 
verifyCodesList<codeArr>否指定券码阶梯价序号
isProductCheckString是是否校验订单产品规则是Y，否N
requestIdString是请求流水号确保永久唯一性32位长度
refNoString否系统参考号12位长度
cashierTransNoString否收银机流水号最长64位长度
storeInfoObject<storeInfo>否此信息为线下门店核销时上送线下核销必填
cashTotalAmountNumber否订单总金额单位：分
goodsDetailList<goodsDetail>否(只有在收银POS上发起交易时才上送) 
remarkString否备注（在核销撤销、核销查询等接口原样返回） 

请求报文举例

{
    "verifyScene":"online",
    "codes": ["10215523190570712621"],
    "requestId": "20181019112535100000000000000001",
    "refNo": "181215430700",
    "cashierTransNo": "42441908138100007498001",
    "storeInfo": {
        "cityId":"1012",
        "shopNo": "C00001",
        "shopName": "上海浦东测试门店",
        "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是请求返回信息 
data/checkResultObject<data/checkResult>是券码核销信息明细返回

返回报文举例

{
    "requestId": "10000000000000000000002",
    "returnCode": "00",
    "returnMsg": "操作成功",
    "data": {
        "verifyResult":[{
              "code":"1021242013780905000",
              "saleChannelCode":"990001",
              "saleChannelCode":"易百码",
              "status":"00",
              "fundsChannel": {
                      "discountAmount": 3000,
                      "merchantRealAmount":0.0,
                      "channelBenefit": 0.0,
                      "merchantBenefit": 0.0
              },
              "faceValue":3000,
              "ticketId":"3",
              "ticketName":"30元现金抵价券",
              "returnCashParam":{
                    "tenderCode":"135"
              }
        },{
              "code":"1021242013780905000",
              "saleChannelCode":"990001",
              "saleChannelCode":"易百码",
              "status":"06",
              "fundsChannel": {
                    "discountAmount": 1000,
                    "merchantRealAmount":0.0,
                    "channelBenefit": 0.0,
                    "merchantBenefit": 0.0
              },
              "faceValue":1000,
              "ticketId":"6",
              "ticketName":"10元现金抵价券",
              "returnCashParam":{
                    "tenderCode":"132"
              }
        }]
    }
}

status枚举

字段字段意义备注
00可使用
01已使用
03未激活未激活的码需调用激活接口才能
04已冻结
05已作废
06已过期 
07未生效当制码时选择次日生效，核销时会返回该状态
09码不存在
10券码状态异常，券码无效
23商户商品号传送错误
26券码不能在本门店使用
C1商户号门店信息有误
C2商户无权限
T2易百调用第三方失败
A4其他异常
Back to top