按礼品卡号查询卡信息
接口用途
- 供门店查询卡相关信息
接口地址
https://ebuywebposp-test.e-buychina.com/ebuyweb-posp/api/getCardInfo
action
getCardInfo
请求参数,中间件===>易百后台
字段 | 类型 | 是否必填 | 字段意义 | 备注 |
---|---|---|---|---|
traceNo | String | 是 | 收银机流水号 | 不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列 |
onlineTid | String | 否 | 线上对接使用的统一终端号 | 对接前需提前和易百技术沟通 |
cardNo | String | 是 | 礼品卡卡号 | 卡号 |
orderRemark | String | 否 | 订单备注 | 订单备注信息,除基本信息,也用于部分透传字段场景使用,如品牌核销渠道等。 |
请求报文举例
{
"traceNo": "TEST16876718849999000003",
"onlineTid": "",
"cardNo": "9531761027959980000026"
}
返回参数,易百后台===>中件间
字段 | 类型 | 是否必填 | 字段意义 | 备注 |
---|---|---|---|---|
traceNo | String | 是 | 收银机流水号 | 不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列 |
orderNo | String | 是 | 本次查询操作易百交易号 | |
transDate | String | 是 | 交易时间 | 格式为:yyyyMMddHHmmss |
returnCode | String | 是 | 返回码 | 00表示本次查询请求成功 |
returnDesc | String | 是 | 返回信息 | 交易结果描述或错误原因 |
cardInfo | Object<cardInfo> | 是 | 礼品卡信息 | 当returnCode为00时才返回 |
orderRemark | String | 否 | 订单备注 | 订单备注信息,除基本信息,也用于部分透传字段场景使用,如品牌核销渠道等。 |
返回报文举例
{
"returnCode": "00",
"returnDesc": "交易成功",
"cardInfo": {
"cardNo": "",
"cardStatus": "11",
"effectStartTime": 1733021696000,
"expireTime": 1735613696000,
"bindSuccessTime": 0,
"lastUseTime": 0,
"cardId": "",
"cardName": "",
"cardFaceValue": 0,
"cardNetValue": 0,
"cardBalance": 150,
"extraInfo": ""
},
"traceNo": "TEST16876718849999000003",
"transDate": "20230625134444"
}
No Comments