异步第三方制码
接口用途
- 用于异步第三方制码的请求参数,发送到whale-gateway数据格式
接口说明
- 这里规定了标准的请求报文格式,发送到whale-gateway模块,然后具体对于不同码商的报文格式需要gateway转换
action
- MakeCode
请求参数,whale===>whale-gateway
字段 | 类型 | 是否必填 | 字段意义 | 备注 |
channelId | String | 是 | 渠道Id | |
channelTicketId | String | 是 | 渠道批次Id | |
codeValidEnd | String | 是 | 券码有效期结束时间 | 格式为yyyyMMdd235959 |
codeValidStart | String | 是 | 券码有效期开始时间 | 格式为yyyyMMdd000000 |
faceValue | Double | 是 | 券面值 | |
netValue | Double | 是 | 净值 | |
orderId | String | 是 | 订单Id | |
requestId | String | 是 | 请求流水号 | |
saleChannelOrderId | String | 是 | 外部订单编号 | |
totalCount | String | 是 | 制码数量 | |
transDate | String | 是 | 交易日期 |
格式为 yyyyMMdd |
transTime | String | 是 | 交易时间 |
格式为 yyyyMMddHHmmss |
useTimes | String | 是 | 可核销次数 | |
whaleTicketId | String | 是 | whale券Id | |
saleChannelItemId | String | 是 | 子订单号 |
请求报文举例
{
"orderId": "c31f244e54bc4c37a321f8359f7bf6310",
"requestId": "c31f244e54bc4c37a321f8359f7bf6310",
"saleChannelOrderId": "b202201184j4j7j5t089",
"transDate": "20220118",
"transTime": "20220118000132",
"items": [
{
"saleChannelItemId": "b202201184j4j7j5t089",
"channelId": "26",
"channelTicketId": "00000041453b559e",
"codeValidEnd": "20220216235959",
"codeValidStart": "20220118000000",
"faceValue": 3000,
"netValue": 3000,
"totalCount": "1",
"useTimes": "1",
"whaleTicketId": "1000000011097"
},
{
"saleChannelOrderId": "b202201184j4j7j5t089",
"channelId": "26",
"channelTicketId": "00000041453b559e",
"codeValidEnd": "20220216235959",
"codeValidStart": "20220118000000",
"faceValue": 3000,
"netValue": 3000,
"totalCount": "1",
"useTimes": "1",
"whaleTicketId": "1000000011097"
}
]
}
返回参数,whale-gateway===>whale
字段 | 类型 | 是否必填 | 字段意义 | 备注 |
returnCode | String | 是 | 请求返回码 | |
returnMsg | String | 是 | 请求返回信息 | |
否 | ||||
thirdCodeFamilySet | List<CodeFamilyInfoBO> |
返回报文举例
{
"returnCode": "00",
"returnMsg": "SUCCESS",
"data": {}
}