5.14对接第三方会员平台
说明
此协议由第三方会员平台实现并供平台使用三方会员卡时调用，实现下列功能:
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":"绑定成功",
"data": {"cardid": "1000000000000977",
"cardno": "1097788",
"crname": "张三丰","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",
"crname": "张三丰","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",
"balance": 1000,}
}
| 参数 | 参数名称 | 必填 | 描述 | 范例 |
| 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":"会员卡不存在"}