异步第三方制码
接口用途
- 用于异步第三方制码的请求参数,发送到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 | 是 | 请求返回信息 | |
| sendChannelOrderId | String | 否 | 订单号 | |
| thirdCodeFamilySet | List<CodeFamilyInfoBO> |
返回报文举例
{
"returnCode": "00",
"returnMsg": "SUCCESS",
"data"sendChannelOrderId": {}"",
"thirdCodeFamilySet": []
}