码作废（退款）接口

接口用途 

 当需要 作废 码时，取码方调用此接口 

 接口说明 

 码表中以掩码为分表位，每查询某个码时必须有明确的码号。 

 已撤销(作废)/使用的码不能转换为其他状态。 

 冻结和解冻操作是相对的。 

 action 

 CodeStatusUpdate 

 请求参数，CHANNEL===> WHALE 

 字段 

 类型 

 是否必填 

 字段意义 

 备注 

 requestId 

 String 

 是 

 请求流水号 

 32个字符，用于标识唯一一笔交易 

 code 

 String 

 是 

 码号 

 小于22个字符 

 optTag 

 String(2) 

 是 

 操作分类 

 01：作废 

 请求报文举例 

 {

 "requestId": "20181019112535100000000000000008",

 "code": "1021242013780905000",

 "optTag":"01"

}

 

 返回参数， WHALE ===>CHANNEL 

 字段 

 类型 

 是否必填 

 字段意义 

 备注 

 returnCode 

 String 

 是 

 请求返回码 

 

 returnMsg 

 String 

 是 

 请求返回信息 

 

 data 

 Object< statusUpdateData > 

 否 

 码状态更新返回数据 

 返回报文举例 

 {

 "returnCode": "00",

 "returnMsg": "SUCCESS",

 "data": {

 "updateDate": "20241224",

 "codeSecret": "10032891673449546316",

 "codeValidEnd": "20250323235959",

 "statusDesc": "已作废",

 "data": {},

 "tradeNo": "0601f61bf54a46b8a01899b444d47a38",

 "codeValidStart": "20241224000000",

 "currentStatus": "05",

 "updateTime": "20241224093435",

 "ticketId": 1000030006397

 }

} 

 失败返回报文举例 

 {

 "returnCode": "32",

 "returnMsg": "流水号重复，请调用查询接口",

 "data": {}

} 

 {

 "returnCode": "91",

 "returnMsg": "该码已使用不能更新状态[100***8707]",

 "data": {}

} 

 {

 "returnCode": "91",

 "returnMsg": "该码已作废不能更新状态[100***6316]",

 "data": {}

} 

   

 券状态枚举 

 字段 

 字段意义 

 备注 

 91 

 更新码状态不支持当前操作 

 更新码状态不支持当前操作 

 10 

 券码不存在 

 

 02 

 本操作不支持，流水号长度不正确