Skip to main content

异步批量发码

接口用途

  • 电子凭证取码方需要批量(一次请求取码数超过1条)制码时，调用此接口

接口说明

  • 每一次取码方对接whale进行制码，生成一个制码订单。
  • 制码订单以渠道方订单编号为分表位，每次调用时必须有明确的订单编号。
  • 制码请求接收后，会同步返回制码前校验结果，后端成功生成码后，异步通知到callBackUrl指定的回调接口。

action

  • MakeBatchCode

请求参数，CHANNEL===>WHALE

字段类型是否必填字段意义备注
saleChannelOrderIdString是渠道制码订单id小于64个字符
requestIdString是请求流水号32个字符，用于标识唯一一笔交易
callBackUrlString是异步结果回调地址易百以POST请求方式推送
itemsList<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

字段类型是否必填字段意义备注
returnCodeString是请求返回码 
returnMsgString是请求返回信息 
batchMakeCodeResponseDataObject<batchMakeCodeResponseData>否批量制码返回数据

返回报文举例

{
    "returnCode": "00",
    "returnMsg": "SUCCESS",
    "data": {
        "saleChannelOrderId": "201811261721",
        "saleChannelId": 99000014,
        "tradeNo": "4a784d0ec74d4211bb3c425f004f95ac",
        "createTime": "20181126172115",
        "codeNum": 5,
        "createDate": "20181126"
    }
}
Back to top