Skip to main content

异步批量发码

接口用途

  • 电子凭证取码方需要批量(一次请求取码数超过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"
    }
}