企迈云-开放平台

API 3.0

7 新会员

API 3.0 > 7.2 礼品卡api > 7.2.11 卡号、卡密兑换礼品卡--返回对应的礼品卡列表

7.2.11 卡号、卡密兑换礼品卡--返回对应的礼品卡列表

开启令牌和权限后可调用。签名方式请查看开发指南

场景描述：卡号、卡密兑换礼品卡--返回对应的礼品卡列表

餐饮

请求地址

请求方式	版本信息	请求地址
POST	V3	http://openapi.zvcms.com/v3/coupon/card/exchangeGiftCard

公共参数

参数	参数类型	是否必填	描述
openId	string	是	密钥Id
grantCode	string	是	授权code
token	string	是	签名，参考《数字签名sign》
timestamp	string	是	当前时间戳
nonce	string	是	随机正整数
params	array	是	业务参数

请求参数

参数	参数类型	是否必填	描述
bizId	string	是	业务唯一标志
cardCode	string	是	卡密
cardNo	string	是	卡号
customerId	string	是	会员id
gainChannel	string	否	获取渠道，1-微信小程序，2-支付宝小程序，3-H5页面，4-商家页面，5-内部接口 (业务能确定就传入)

响应参数

参数	参数类型	描述
status	bool	成功或失败标识
code	int	成功或失败代码
message	string	描述
data	array
├0	array
├amount	int	面值
├bindValidUnit	int	有效单位1-年，2-月
├cardNo	string	礼品卡卡号
├customerId	string	用户id
├giveCount	int	可赠送次数【null不限制赠送,0不可赠送】
├imageUrl	string	卡面
├name	string	名称
├salePrice	int	售价
├templateId	string	模板id
├validBeginDate	DateTime	有效开始时间
├validEndDate	DateTime	有效结束时间
├validTime	string	有效时间
├validType	string	有效期类型，1-长期有效,2,自绑定日起xxx有效，3-固定日期

请求示例

{
    "openId": "6dc05b4ac175cf316d226252b05cf685",
    "grantCode": "782c281f62",
    "timestamp": "1547186244",
    "nonce": "658965",
    "token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "params": {
        "bizId": "",
        "cardCode": "",
        "cardNo": "",
        "customerId": "",
        "gainChannel": ""
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": [
        {
            "amount": "",
            "bindValidUnit": "",
            "cardNo": "",
            "customerId": "",
            "giveCount": "",
            "imageUrl": "",
            "name": "",
            "salePrice": "",
            "templateId": "",
            "validBeginDate": "",
            "validEndDate": "",
            "validTime": "",
            "validType": ""
        }
    ]
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}

免费升级

营销功能、插件持续每月更新开发升级

免费专业培训

每月建站、微信营销、电商等互联网增值培训

7×24小时服务支持

400电话、QQ、微信、在线等多渠道售后支持