文档

测试

4.5会员查询

websocket测试

POST

getCustomerByScancode

接口描述

取得会员信息，可用于查询余额；君容消费机增加手机查询

请求参数

参数名

类型

描述

必填

token

String

登录TOKEN

必填

appid

String

商户appid

必填

card_no

String

会员卡序列号或动态会员码；与phone_number二者必填一个

可选

phone_number

String

手机号：建立时输入的手机号，与card_no二者必填一个

可选

响应参数

参数名

类型

描述

必填

code

int

错误码，成功返回 200，失败返回其它

必填

message

String

错误描述

必填

data

Object

对象，业务数据

必填

customer

Object

对象，会员对象，以下是部分重要的会员对象字段

必填

customer_id

Long

会员卡 ID

必填

customer_name

String

会员名

必填

cuttomer_code

String

会员卡编号

必填

customer_sn

String

会员卡序列号，同请交参数 card_no 值

必填

phone_number

String

手机号

必填

enabled

int

会员卡状态：1使用中，0挂失状，-1已注销

必填

balance

Double

会员卡余额，余额=本金余额+补贴/赠送余额

必填

cash

Double

本金余额

必填

subsidy

Double

补贴/赠送余额

必填

说明 / 示例

### 请求示例 ``` https://api2.XXX.cn/cm/getCustomer?token=TOKEN&appid=jb25112e65f20e7dfe&card_no=000343433 ``` ### 返回示例 #### 成功返回 JSON ``` { "code": 200, "message": "success", "data": { "result_msg": "ok", "result_code": "success", "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:57:14", "enabled": 1 } } } ``` #### 失败返回 ``` "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== 会员不存在或已注销，一般是会员卡号错误

上一篇 4.4结算与退卡

nextDoc 5.1日结查询