Skip to main content

券码历史记录查询

接口用途

  • 券码历史记录查询 （根据上送券码，查询当前券码历史相关记录信息）

action

  • /api/whaleStarbucksCode/getCodeRecords

请求参数，中间件===>易百后台

字段 类型 是否必填 字段意义 备注
requestId String 是 流水号 不允许重复，用于单次请求日志追踪查询
code String 是 券码 券号code
sign String 是 签名串 券码查询签名串

请求报文举例

{
    "requestId": "99000009100010101732123"1006250730320020870=gHN3981K",
    "code": "R156A001-0000491-0505,R156A002-0000491-0505"1754016596841",
    "sign": 12"IkC1dq8cIw5nbT9xiNBTeNFXfFesRJCv84bSq3/Fw4K6KDaUwARXaZ9b9Z7x8Xv8N8ebitCXxjqj+k8CBtXSsyvRmRBEdmcZWe5CEY+J6nROdup3QTL0h1RB+u7/RugDl6wXOLZDd4WSLpSSEd41iQh3J3U4OtHHoBOq62lOPzJJTiJVKQUUtv8+kR31hEImP+r53EAeqQstCSkfpXA/xpwEtikvfwJ5TI+V709S+B5fzTFVldhLo14jfIA4HpiSQY1GrFpvTmzWnvS4ibU/it9bKMPrSYfE7Q4uAV+ajxdsQ1UDgMhesapkDjdhlxUhKB4HJGGgVfsMk5L0Z+3N0A=="
}

返回参数，易百后台===>中件间

字段 类型 是否必填 字段意义 备注
traceNo String 是 收银机流水号 不允许重复
transDate String 是 交易时间 格式为：yyyyMMddHHmmss
returnCode String 是 返回码 P00表示待激活（可激活）；P01表示正在激活中（不可激活）；P02表示有部分券处于不可激活状态（不可激活）；P03表示已全部激活；P09表示该门店该城市不可激活
returnDesc String 是 返回信息 交易结果描述或错误原因
voucherPkg List<voucherPkg> 否 电子券包信息 返回电子券包信息

返回报文举例（请求中 businessType 值为 12 时）

{
    "returnCode": "00",
    "transTime": 1754016597099,
    "requestId": "1754016596841",
    "returnData": [
        {
            "dateTime": "20250730143743",
            "returnCode": "00",
            "returnMsg": "操作成功",
            "code": "1006250730320020870=gHN3981K",
            "mid": "",
            "shopName": "",
            "type": "1",
            "shopNo": "",
            "tid": "",
            "swift": ""
        },
        {
            "dateTime": "20250730153314",
            "returnCode": "00",
            "returnMsg": "SUCCESS",
            "code": "1006250730320020870=gHN3981K",
            "mid": "860020051401034",
            "shopName": "星巴克北京银泰店",
            "type": "2",
            "shopNo": "1490",
            "tid": "54022101",
            "swift": "0"
        },
        {
            "dateTime": "20250730211518",
            "returnCode": "00",
            "returnMsg": "SUCCESS",
            "code": "1006250730320020870=gHN3981K",
            "mid": "860020051401034",
            "shopName": "星巴克北京银泰店",
            "type": "2",
            "shopNo": "1490",
            "tid": "54022101",
            "swift": "0"
        }
    ],
    "returnDesc": "success"
}
Back to top