Skip to main content

异步第三方制码

接口用途

  • 用于异步第三方制码的请求参数,发送到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 子订单号  

请求报文举例

{
  "channelId": "136",
  "faceValue": -1,
  "makeFundsChannel": {
    "benefitAmount": 0,
    "channelBenefit": 0,
    "discountAmount": 0,
    "merchantBenefit": 0,
    "merchantCustomBenefit": -1,
    "merchantCustomRealAmount": -1,
    "merchantRealAmount": 10,
    "totalAmount": 100,
    "userRealAmount": 80
  },
  "netValue": -1,
  "orderId": "d84c1302a5e84774813bc9f1b7aaea8a",
  "orderRemark": "testtttt",
  "requestId": "d84c1302a5e84774813bc9f1b7aaea8a",
  "saleChannelOrderId": "d84c1302a5e84774813bc9f1b7aaea8a",
  "totalCount": "1",
  "transDate": "20220506",
  "transTime": "20220506215213",
  "useTimes": "12",
  "whaleTicketId": "162"
}

返回参数,whale-gateway===>whale

字段 类型 是否必填 字段意义 备注
returnCode String 请求返回码  
returnMsg String 请求返回信息  
sendChannelOrderId String 订单号  
thirdCodeFamilySet List<CodeFamilyInfoBO>      

返回报文举例

{
	"returnCode": "00",
    "returnMsg": "SUCCESS",
    "sendChannelOrderId": "",
    "thirdCodeFamilySet": []
}