文档
测试

4.1建卡

POST
createCustomer

请求参数

参数名
类型
描述
必填
token
String
登录TOKEN
必填
appid
String
商户appid
必填
card_no
String
会员卡序列号
必填
customer_code
String
会员卡编号(卡面印刷编号 )
可选
phone_number
String
手机号,需要挂失的场景下,必须传入
可选

响应参数

参数名
类型
描述
必填
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/createCustomer?token=TOKEN&appid=jb25112e65f20e7dfe&card_no=000343433&customer_code=008880&phone_number=13500003333 ``` ### 返回示例 #### 成功返回 JSON ``` { "code": 200, "message": "success", "data": { "data": { "shared": 1, "balance": 0.0, "subsidy": 0.0, "phone_number": "", "customer_name": "", "customer_id": 1581, "customer_sn": 0849800579, "create_date": "2021-05-24 11:26:04", "customer_code": "", "cash": 0.0, "update_date": "2021-05-24 11:26:04", "enabled": 0 } } } ``` #### 失败返回 ``` "code": 1502, "message": "business.error.netShopId.isnotExist", "data": "" } ``` ==business.error.netShopId.isnotExist== 商户appid不存在 ``` { "code": 4001, "message": "business.error.customer.isExist", "data": "" } ``` ==business.error.customer.isExist== 会员已存在,一般是卡号或手机号或编号 重复,这三都都要唯一