Skip to main content

批量激活卡券(开发设计中)

接口用途

  • 供门店激活一批卡或券

接口地址

  • https://ebuywebposp-test.e-buychina.com/ebuyweb-posp/api/batchActivate

action

  • batchActivate

请求参数，中间件===>易百后台

字段 类型 是否必填 字段意义 备注
traceNo String 是 收银机流水号 不允许重复，必须以yyyyMMdd(当天)作为流水号开头+递增序列
onlineTid String 否 线上对接使用的统一终端号 对接前需提前和易百技术沟通
activateType String 是 激活类型 1：券；2：预付卡
posOrderNo String 是 pos订单号 pos订单号，由商家自定义需保证在商户端不重复
totalAmount Price 是 交易总金额 单位：元
userRealAmount Price 是 用户实付 单位：元
receiptAmount Price 是 商户实收金额 单位：元
codeValidDays Number 否 相对有效天数 码相对有效期天数和码有效开始结束时间段任选其一必填
codeValidStart String 否 码有效开始时间
codeValidEnd String 否 码有效结束时间
codeDetail List<codeDetail> 是 待激活卡券列表
orderRemark String 否 订单备注 订单备注信息，除基本信息，也用于部分透传字段场景使用

请求报文举例

{
  "traceNo": "99000009100010101732123",
  "activateType": 1,
  "posOrderNo": "R156A001",
  "totalAmount": 30,
  "userRealAmount": 30,
  "receiptAmount": 30,
  "codeValidDays": 60,
  "codeDetail": [
    {
      "code": "10032798249073253036",
      "password": ""
    },
    {
      "code": "10015637155993363522",
      "password": ""
    }
  ],
  "orderRemark": ""
}

返回参数，易百后台===>中件间

字段 类型 是否必填 字段意义 备注
traceNo String 是 收银机流水号 不允许重复
orderNo String 是 本次激活操作订单号  
transDate String 是 交易时间 格式为：yyyyMMddHHmmss
returnCode String 是 返回码 00仅表示本次请求成功，并不代表所有码都激活成功
returnDesc String 是 返回信息 交易结果描述或错误原因
codeDetail List<codeDetail> 是 激活结果列表
orderRemark String 否 订单备注 订单备注信息，除基本信息，也用于部分透传字段场景使用

返回报文举例

{
  "traceNo": "99000009100010101732123",
  "orderNo": "99000009100010101732123"195003459749",
  "transDate": "20161231120533",
  "returnCode": "00",
  "returnDesc": "SUCCESS",
  "codeDetail": [
    {
      "code": "10032798249073253036",
      "ticketId": "",
      "ticketName": "",
      "useTimes": 1,
      "resultCode": "",
      "resultDesc": ""
    },
    {
      "code": "10015637155993363522",
      "ticketId": "",
      "ticketName": "",
      "useTimes": 1,
      "resultCode": "",
      "resultDesc": ""
    }
  ],
  "orderRemark": "天猫"
}
Back to top