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": []
}