5.8实体卡迁移转入微卡
优质
小牛编辑
121浏览
2023-12-01
说明
此协议用于在商家软件里将客户实体卡的余额、积分转入微信卡。此协议合并上传余额和积分，并且上传余额不会触发充值奖励活动。
流程：
1.客户持有商家实体卡，并在商家微信平台上已领取微信卡。
2.在商家软件界面中分别输入实体卡号和客户微信卡号。
3.软件调用本协议，返回转入成功。
注意：平台不能判断一张卡是否已转入过，请自行处理避免多次重复转入。
请求地址
http://api.dc78.cn/Api/mb_cardtransfer
请求方式
GET
请求参数
| 参数 | 参数名称 | 必填 | 描述 | 范例 |
card_id | 实体卡id | 卡唯一id | ||
| card_no | 实体卡号 | |||
| id | 微卡、通卡id | 输入或扫微信卡二维码后，先使用协议5.1获得微信卡id | ||
| balance | 会员卡储值余额 | |||
| pt | 会员卡积分余额 | 注意：余额和积分至少要有一个，否则转入不成功 | ||
| 2017-03-18新增： | ||||
| bind | bind=1，转入的同时绑定会员卡。绑定的同时平台卡号会改成card_no（注意卡号不能重复），线下可以直接用此卡号进行接口调用。 | |||
| password | password=xxx，bind=1时可以同时设置卡密码 | |||
返回
{
"status": "1",
"info": "卡转入成功",
"id": "361810",
"bal": "2848.41",
"pt_balance": "38909",
"server_time": "2015-09-22 09:26:16"
}
| 参数 | 参数名称 | 必填 | 描述 | 范例 |
| bal | 微信卡余额 | 2848.41 | ||
| pt_balance | 积分余额 | 38909 |
建议
请注意返回的信息，如果余额和积分同时存在，意外情况时会发生余额转入成功但积分不成功的情况,返回信息如下:
“卡余额转入成功，积分:200转入失败,请手工处理积分”此时可以尝试再次执行并只传积分。
请求方式
INI
请求参数
| [action] | 描述 |
| action=mb_cardtransfer | |
| [get] | 描述 |
| card_id=实体卡id(卡唯一id) | |
| card_no=实体卡号 | |
| id=微卡、通卡id(输入或扫微信卡二维码后，先使用协议5.1获得微信卡id) | |
| balance=会员卡储值余额 | |
| pt=会员卡积分余额，（注意：余额和积分至少要有一个，否则转入不成功） |
返回
[result]
status=1
info=卡转入成功
id=361810
bal=2848.41
pt_balance=38909
server_time=2015-09-22 09:26:16
| [result] | 描述 |
| status=1 | |
| info=卡转入成功 | |
| id=361810 | |
| bal=2848.41 | |
| pt_balance=38909 | |
| server_time=2015-09-22 09:26:16 |