异步批量发码
接口用途
- 电子凭证取码方需要批量(一次请求取码数超过1条)制码时,调用此接口
接口说明
- 每一次取码方对接whale进行制码,生成一个制码订单。
- 制码订单以渠道方订单编号为分表位,每次调用时必须有明确的订单编号。
- 制码请求接收后,会同步返回制码前校验结果,后端成功生成码后,异步通知到callBackUrl指定的回调接口。
action
MakeBatchCode
请求参数,CHANNEL===>WHALE
字段 | 类型 | 是否必填 | 字段意义 | 备注 |
---|---|---|---|---|
saleChannelOrderId | String | 是 | 渠道制码订单id | 小于64个字符 |
requestId | String | 是 | 请求流水号 | 32个字符,用于标识唯一一笔交易 |
callBackUrl | String | 是 | 异步结果回调地址 | 易百以POST请求方式推送 |
items | List<items> | 是 | 制码子订单 | 一次制码请求最多支持10个子订单 |
请求报文举例
{
"saleChannelOrderId": "20180912162026",
"requestId": "20180912162026",
"totalAmount": "15800",
"notifyType": {
"mobilePhone": "13524161800"
},
"callBackUrl": "http://*****/***/api",
"items": [{
"saleChannelItemId": "20180912162026001",
"ticketId": 1,
"validDays": 10,
"validStart": "20180730000000",
"validEnd": "20181201235959",
"codeNum": 2,
"makeFundsChannel": {
"channelBenefit": 0,
"merchantBenefit": 500,
"userRealAmount": 2500
}
}, {
"saleChannelItemId": "20180912162026002",
"ticketId": 2,
"validDays": 10,
"validStart": "20180730000000",
"validEnd": "20181201235959",
"codeNum": 1,
"makeFundsChannel": {
"channelBenefit": 100,
"merchantBenefit": 0,
"userRealAmount": 900
}
}]
}
返回参数,WHALE===>CHANNEL
字段 | 类型 | 是否必填 | 字段意义 | 备注 |
---|---|---|---|---|
returnCode | String | 是 | 请求返回码 | |
returnMsg | String | 是 | 请求返回信息 | |
batchMakeCodeResponseData | Object<batchMakeCodeResponseData> | 否 | 批量制码返回数据 |
返回报文举例
{
"returnCode": "00",
"returnMsg": "SUCCESS",
"data": {
"saleChannelOrderId": "201811261721",
"saleChannelId": 99000014,
"tradeNo": "4a784d0ec74d4211bb3c425f004f95ac",
"createTime": "20181126172115",
"codeNum": 5,
"createDate": "20181126"
}
}
No Comments