文档
测试

4.3挂失

POST
freezeCustomer

接口描述

挂失与解除挂失:建卡时,有登记手机号的卡,可以通过手机短信验证码挂失和解除挂失。当前状态为非挂失时,此为挂失接口;当前状态为挂失时,此为解解挂失接口。

请求参数

参数名
类型
描述
必填
token
Stribg
登录TOKEN
必填
appid
String
商户appid
必填
phone_number
String
手机号,会员卡绑定的手机号
必填
valid_code
String
短信验证码
必填

响应参数

参数名
类型
描述
必填
code
int
错误码,成功返回 200,失败返回其它
必填
message
String
错误描述
必填
data
Object
对象,业务数据
必填
customer
Object
对象,会员对象,以下是部分重要的会员对象字段
必填
customer_id
Long
会员卡 ID
必填
customer_name
String
会员名
必填
cuttomer_code
String
会员编号
必填
customer_sn
String
会员卡序列号
必填
phone_number
String
手机号
必填
enabled
int
会员卡状态:1使用中,0挂失状,-1已注销
必填
balance
Double
会员卡余额,余额=本金余额+补贴/赠送余额
必填
cash
Double
本金余额
必填
subsidy
Double
补贴/赠送余额
必填

说明 / 示例

### 请求示例 ``` https://api2.XXX.cn/cm/hangupCustomer?token=TOKEN&appid=jb25112e65f20e7dfe&phone_number=13500003333&valid_code=345669 ``` ### 返回示例 #### 成功返回 JSON ``` { "code": 200, "message": "success", "data": { "customer": { "shared": 1, "balance": 9910.0, "subsidy": 1000.0, "phone_number": "13899996666", "customer_name": "", "customer_id": 1581, "customer_sn": "0849800579", "create_date": "2021-05-24 11:26:04", "customer_code": "", "cash": 8910.0, "update_date": "2021-05-24 13:36:37", "enabled": 0 } } } ``` #### 失败返回 ``` "code": 1502, "message": "business.error.netShopId.isnotExist", "data": "" } ``` ==business.error.netShopId.isnotExist== 商户appid不存在 ``` "code": 4005, "message": "business.error.customer.notFound", "data": "" } ``` ==business.error.customer.notFound== 会员不存在或已注销,一般是phone_number传入的手机号,没有绑定会员卡