Skip to main content

同步单条发码

接口用途

  • 当取支持请码方一次单品请求只取一张券时调用，后端,单品发码数量上限制此接口也只能一次取一张券100

接口说明

  • 每次调用时必须有明确的渠道订单编号。
  • commissionDate = -1时，所制码不具有支付功能（即码没有激活），如果需要激活该码的支付功能需要再次调用"码激活"接口。
  • 同步单条发码时，saleChannelOrderId和saleChannelItemId可用同一值。
  • returnCode = "00"时，说明订单进入制码流程。itemResultCode = "00"时，说明订单制码成。
  • notifyType为券码发送到用户的形式，是否需要通知以券配置为开关

action

  • MakeCode

请求参数，CHANNEL===>WHALE

字段 类型 是否必填 字段意义 备注
saleChannelOrderId String 是 渠道制码订单id 最长32位，当上送相同订单号时返回上一次成功信息，如果上一次请码失败，则本次会重新生成码
requestId String 是 请求流水号 最长32位，用于标识唯一一笔交易
remark JSONString 是 订单备注信息 最长200位，订单查询时原样返回
notifyType Object<notifyType> 否 制码通知类型  
item Object<makeOrderItems> 是 制码明细 同步制码时，仅支持单产品单码

请求报文举例

{
    "saleChannelId": "102410058",
    "saleChannelOrderId": "20181024154201",
    "requestId": "20181024154201",
    "notifyType": {
            "mobilePhone": "13524161800"
    },
    "item": {
        "saleChannelItemId":"20181024154201",
        "commissionDate":"1",
        "validDays": 10,
        "ticketId": 1,
        "makeFundsChannel": {
            "channelBenefit": 0,
            "merchantBenefit": 500,
            "userRealAmount": 2500
        }
    }
}

返回参数，WHALE===>CHANNEL

字段 类型 是否必填 字段意义 备注
returnCode String 是 请求返回码  
returnMsg String 是 请求返回信息  
data Object<makeCodeResponseData> 否 码信息

返回报文举例

{
    "returnCode": "00",
    "returnMsg": "SUCCESS",
    "data": {
        "saleChannelOrderId": "20181120155110",
        "tradeNo": "c1eca7fbda51430cb5100ec0699a5b00",
        "createTime": "20181120155225",
        "isNotify": "1",
        "codeNum": 1,
        "items": [{
            "codeDetail": [{
                "codeURL": "http://qrcode.url.ag/make?0000001496A382FA4725D24FA27839FC1680D136CAFE515519B94B1D&type=QRCODE",
                "code": "10116574123700278846",
                "useTimes": 10,
                "status": "00",
                "statusDesc": "未使用"
            }],
            "validEnd": "20181201000000",
            "validStart": "20181121000000",
            "itemResultMsg": "SUCCESS",
            "itemResultCode": "00",
            "saleChannelItemId": "20181120155110",
            "ticketId": 9000000010,
            "ticketName":"星巴克30元代金券",
            "activityId":"1000000006",
            "activityName":"中信银行星巴克代金券活动"
        }],
        "createDate": "20181120"
    }
}

券状态枚举

字段 字段意义 备注
04 参数配置不正确

RequestId参数不能为空

appId参数不能为空
50 活动产品信息不存在
97 活动产品信息不存在 活动产品信息不存在
或者其他配置信息错误
06 活动产品未经过测试
50 销售渠道信息不存在
07 销售渠道和活动产品权限不匹配
Back to top