说明
此协议由第三方会员平台实现并供平台使用三方会员卡时调用，实现下列功能:
1.会员第三方会员卡与微信卡的绑定和查询显示
2.三方会员卡充值、扣款
注意：
1.需要将三方平台接口地址填入平台相关设置
2.三方平台需要使用云平台、固定IP地址等对接方式，不支持花生壳等动态域名方式！
请求地址
http://三方会员平台地址/ （此地址由商户设置在平台会员相关设置中）
请求方式
GET
公共参数
1.公共参数（下列的所有协议中都会包含公共参数）
| 参数 | 参数名称 | 必填 | 描述 | 范例 |
| type | 请求类型 | 是 | 请求操作的类型 query:查询会员卡，bind:绑定微信卡，tran:会员卡交易 | query |
| mcid | 平台企业编号 | 是 | 平台企业编号 | 1159 |
| time_stamp | 时间 | 是 | 时间yyyyMMddHHmms | 20160609111008 |
| msg_sign | 协议签名 | 是 | 签名方式同平台API签名方式 |
会员卡绑定（type=bind）
2.会员卡绑定（type=bind）
参数 参数名称 必填 描述 范例 mbid 微信会员id 是 微信会员id 2012773 mbno 微信会员卡号 是 微信会员卡号 210277 cardno 三方会员卡号 是 绑定时由用户填写 258888 mobile 三方会员手机号 是 绑定时由用户填写 13912258888
返回：
{
"status":"1",
"info":"绑定成功",
"cardid": "1000000000000977",
"cardno": "1097788",
"balance": 1000,
"points": 2000,
}
参数 参数名称 必填 描述 范例 cardid 三方会员唯一id 1000000000000977 cardno 三方会员卡号 1097788 crname 持卡人 张三丰 balance 卡储值余额 1000 points 卡积分余额 2000
会员查询（type=query）
3.会员查询（type=query）
| 参数 | 参数名称 | 必填 | 描述 | 范例 |
| cardid | 三方会员id | 是 | 会员绑定协议中返回的cardid | 1097788 |
{
"status":"1",
"data": {
"cardid": "1000000000000977",
"cardno": "1097788",
"balance": 1000,
"points": 2000,
}
| 参数 | 参数名称 | 必填 | 描述 | 范例 |
| cardid | 三方会员唯一id | 1000000000000977 | ||
| cardno | 三方会员卡号 | 1097788 | ||
| crname | 持卡人 | 张三丰 | ||
| balance | 卡储值余额 | 1000 | ||
| points | 卡积分余额 | 2000 |
会员卡交易
4.会员卡交易（type=tran）
参数 参数名称 必填 描述 范例 action 交易操作类型 是 "0":储值，"1":扣款1 1 cardid 三方卡唯一id 是 会员绑定协议中返回的cardid 210277 ref 平台交易流水 是 平台交易流水号 PR-582301 amount 金额 是 交易金额 100 subject 交易摘要 否 交易摘要 msid 门店编号 否 交易门店编号 oper 操作员 否 操作员，客人在线使用时无 0001
返回：
{
"status":"1",
"data": {
"cardid": "1000000000000977",
"ref": "2016050911283781237",
}
}
| 参数 | 参数名称 | 必填 | 描述 | 范例 |
| cardid | 三方卡id | 1000000000000977 | ||
| ref | 三方交易流水号 | 2016050911283781237 | ||
| balance | 交易完成后余额 | 1000 |
积分交易
5.会员卡积分交易（type=pttran）
参数 参数名称 必填 描述 范例 action 交易操作类型 是 "0":储值，"1":扣款 1 cardid 三方卡唯一id 是 会员绑定协议中返回的cardid 1097788 ref 平台交易流水 是 平台交易流水号 PR-582301 points 积分 是 交易积分数 1000 subject 交易摘要 否 交易摘要 oper 操作员 否 操作员，客人在线使用时无 0001
返回：
{
"status": "1",
"data": {
"cardid": "1000000000000977",
"ref": "2016050911283781237",
"points": 1000
}
}
| 参数 | 参数名称 | 必填 | 描述 | 范例 |
| cardid | 三方卡id | 1000000000000977 | ||
| ref | 三方交易流水号 | 2016050911283781237 | ||
| points | 交易后积分余额 | 1000 |
会员卡解绑
6.会员卡解绑交易(type=unbind)
| 参数 | 参数名称 | 必填 | 描述 | 范例 |
| cardid | 三方卡唯一id | 是 | 会员绑定协议中返回的cardid | 1097788 |
返回：
{
"status": "1",
"info": "解绑成功"
}
错误返回
{"status":0,"info":"会员卡不存在"}