批量激活卡券(开发设计中)
接口用途
- 供门店激活一批卡或券
接口地址
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 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",
"transDate": "20161231120533",
"returnCode": "00",
"returnDesc": "SUCCESS",
"orderRemark": "天猫"
}