Skip to main content

按礼品卡号查询卡信息

接口用途

  • 供门店查询卡相关信息

接口地址

  • 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"
}