猫酷开放平台

# 积分

# 根据用户ID扣除会员积分

TIP

使用【OpenUserID】来扣除会员积分

接口地址：https://openapi10.mallcoo.cn/User/Score/v1/Subtract/ByOpenUserID/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
UserToken string 否 用户Token
OpenUserId string 是 用户在当前【开发者账号+项目（集团）】下的唯一标识(相当于用户ID)
ScoreEvent enum 是 积分事件（详情看枚举字典）
Score double 是 需要扣除的积分
Reason string 否 积分变动原因
TransID string 是 事务ID（当前应用下不得重复，保证提交的唯一性）
# 调用示例
{ 
  "UserToken": "12a53d83dd02e89a",
  "OpenUserId": "252117ba5367449c",
  "Score": 1,
  "TransID": "e51c1c060eae48d8a3f85037eabb0841",
  "ScoreEvent": 1022
}
1
2
3
4
5
6
7

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Message string 是 返回状态描述
# 返回示例
{
  "Code": 1,
  "Message": "成功"
}
1
2
3
4



# 根据用户ID增加会员积分

TIP

使用【OpenUserID】来增加会员积分

接口地址：https://openapi10.mallcoo.cn/User/Score/v1/Plus/ByOpenUserID/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
UserToken string 否 用户Token
OpenUserId string 是 用户在当前【开发者账号+项目（集团）】下的唯一标识(相当于用户ID)
ScoreEvent enum 是 积分事件（详情看枚举字典）
Score double 是 需要增加的积分
Reason string 否 积分变动原因
TransID string 是 事务ID（当前应用下不得重复，保证提交的唯一性）
# 调用示例
{ 
  "UserToken": "12a53d83dd02e89a",
  "OpenUserId": "252117ba5367449c",
  "Score": 1,
  "TransID": "e51c1c060e1234d8a3f85037eahdyu87",
  "ScoreEvent": 6
}
1
2
3
4
5
6
7

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Message string 是 返回状态描述
# 返回示例
{
  "Code": 1,
  "Message": "成功"
}
1
2
3
4



# 通过手机号增加消费积分

TIP

通过手机号查询会员，增加消费积分

接口地址：https://openapi10.mallcoo.cn/User/Score/V1/Consume/Plus/ByMobile/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
TransID string 是 事物ID（当前应用下不得重复，保证提交的唯一性）
Mobile string 是 手机号
Amount double 是 消费金额
TradeTime DateTime 是 交易时间
McShopID long 否 该商户在猫酷系统中的唯一编号（与CrmShopID、DevShopID任其选一必填）
CrmShopID string 否 该商户在商场CRM系统中的唯一编号（与McShopID、DevShopID任其选一必填）
DevShopID string 否 该商户在本开发者中的唯一编号，若使用此编号，则需提前将商户对应编号导入猫酷系统（与McShopID、CrmShopID任其选一必填）
TradeSerialNo string 否 交易流水号（同一posid下，交易流水号必须不同）
PosID string 否 PosID
PayType enum 否 支付方式（详见支付方式枚举字典）
# 调用示例
{
  "TransID": "e51c1c060eae48d8a3f85037eabb0841",
  "Mobile": "15901996272",
  "Amount": 1000,
  "TradeTime": "2017-03-24 15:16:45",
  "McShopID": 100001,
  "CrmShopID": null,
  "DevShopID": null,
  "TradeSerialNo": "10001001",
  "PosID": "1",
}
1
2
3
4
5
6
7
8
9
10
11

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Data Json 是 返回数据（已积过分时，会返回错误，并告知积分操作时间）
Message string 是 返回状态描述
# Data
名称 数据类型 必填 说明
Score double 是 本次积分
CurScore double 是 当前总积分
OperateTime DateTime 是 操作时间
# 返回示例
{
  "Code": 1,
  "Data": 
  {
      "Score": 1000,
      "CurScore": 2000,
      "OperateTime": "2017-03-31 15:16:45",
  },
  "Message": "成功"
}
1
2
3
4
5
6
7
8
9
10



# 通过手机号增加消费积分V2

TIP

通过手机号查询会员，增加消费积分。V2版本增加了优惠及支付相关字段，用于线上数据分析及营销

接口地址：https://openapi10.mallcoo.cn/User/Score/V2/Consume/Plus/ByMobile/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
TransID string 是 事物ID（当前应用下不得重复，保证提交的唯一性）
Mobile string 是 手机号
PayAmount double 是 支付金额（参与积分的部分）
TradeTime DateTime 是 交易时间
McShopID long 否 该商户在猫酷系统中的唯一编号（与CrmShopID、DevShopID任其选一必填）
CrmShopID string 否 该商户在商场CRM系统中的唯一编号（与McShopID、DevShopID任其选一必填）
DevShopID string 否 该商户在本开发者中的唯一编号，若使用此编号，则需提前将商户对应编号导入猫酷系统（与McShopID、CrmShopID任其选一必填）
TradeSerialNo string 否 交易流水号（同一posid下，交易流水号必须不同）
PosID string 否 PosID
TotalAmount double 是 订单总金额=支付金额+优惠金额
PromotionAmount double 否 优惠金额，默认为0
ConsumePromotionList List<ConsumePromotion> 否 优惠明细列表
ConsumePayList List<ConsumePay> 否 支付明细列表
Remark string 否 备注
# ConsumePromotion
名称 数据类型 必填 说明
PromotionType enum 是 优惠类型 （详见优惠类型枚举字典）
RuleNo string 否 优惠规则编号
No double 否 优惠码
Amount double 是 优惠金额
Desc string 否 优惠说明
# ConsumePay
名称 数据类型 必填 说明
PayType enum 是 支付方式（详见支付方式枚举字典）
PayNo string 否 支付单号
Amount double 是 支付金额
# 调用示例
{
  "TransID": "e51c1c060eae48d8a3f85037eabb0841",
  "Mobile": "15901996272",
  "PayAmount": 1000,
  "TradeTime": "2017-03-24 15:16:45",
  "McShopID": 100001,
  "CrmShopID": null,
  "DevShopID": null,
  "TradeSerialNo": "10001001",
  "PosID": "1",
  "TotalAmount":1000,
  "PromotionAmount":500,
  "Remark":"%e6%b5%8b%e8%af%95%e5%a4%87%e6%b3%a8",
  "ConsumePromotionList":[
        {
            "PromotionType":6,
            "RuleNo":"RNO123",
            "No":"No123456",
            "Desc":"Desc",
            "Amount":200
        },
        {
            "PromotionType":1,
            "RuleNo":"RNO123123",
            "No":"No123456789",
            "Desc":"Desc",
            "Amount":300
        }
    ],
  "ConsumePayList":[
        {
            "PayType":12,
            "Amount":200,
            "PayNo":"PNO123456"
        },
        {
            "PayType":6,
            "Amount":300,
            "PayNo":"PNO123456987"
        },
        {
            "PayType":1,
            "Amount":500,
            "PayNo":"PNO1234569874546"
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Data Json 是 返回数据（已积过分时，会返回错误，并告知积分操作时间）
Message string 是 返回状态描述
# Data
名称 数据类型 必填 说明
Score double 是 本次积分
CurScore double 是 当前总积分
OperateTime DateTime 是 操作时间
# 返回示例
{
  "Code": 1,
  "Data": 
  {
      "Score": 1000,
      "CurScore": 2000,
      "OperateTime": "2017-03-31 15:16:45",
  },
  "Message": "成功"
}
1
2
3
4
5
6
7
8
9
10



# 通过会员卡号增加消费积分

TIP

通过卡号查询会员，增加消费积分

接口地址：https://openapi10.mallcoo.cn/User/Score/V1/Consume/Plus/ByMallCardNo/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
TransID string 是 事物ID（当前应用下不得重复，保证提交的唯一性）
MallCardNo string 是 会员卡号
Amount double 是 消费金额
TradeTime DateTime 是 交易时间
McShopID long 否 该商户在猫酷系统中的唯一编号（与CrmShopID、DevShopID任其选一必填）
CrmShopID string 否 该商户在商场CRM系统中的唯一编号（与McShopID、DevShopID任其选一必填）
DevShopID string 否 该商户在本开发者中的唯一编号，若使用此编号，则需提前将商户对应编号导入猫酷系统（与McShopID、CrmShopID任其选一必填）
TradeSerialNo string 否 交易流水号（同一posid下，交易流水号必须不同）
PosID string 否 PosID
PayType enum 否 支付方式（详见支付方式枚举字典）
# 调用示例
{
  "TransID": "e51c1c060eae48d8a3f85037eabb0841",
  "MallCardNo": "1000001",
  "Amount": 1000,
  "TradeTime": "2017-03-24 15:16:45",
  "McShopID": 100001,
  "CrmShopID": null,
  "DevShopID": null,
  "TradeSerialNo": "10001001",
  "PosID": "1",
}
1
2
3
4
5
6
7
8
9
10
11

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Data Json 是 返回数据（已积过分时，会返回错误，并告知积分操作时间）
Message string 是 返回状态描述
# Data
名称 数据类型 必填 说明
Score double 是 本次积分
CurScore double 是 当前总积分
OperateTime DateTime 是 操作时间
# 返回示例
{
  "Code": 1,
  "Data": 
  {
      "Score": 1000,
      "CurScore": 2000,
      "OperateTime": "2017-03-31 15:16:45",
  },
  "Message": "成功"
}
1
2
3
4
5
6
7
8
9
10



# 通过会员卡号增加消费积分V2

TIP

通过卡号查询会员，增加消费积分。V2版本增加了优惠及支付相关字段，用于线上数据分析及营销

接口地址：https://openapi10.mallcoo.cn/User/Score/V2/Consume/Plus/ByMallCardNo/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
TransID string 是 事物ID（当前应用下不得重复，保证提交的唯一性）
MallCardNo string 是 会员卡号
PayAmount double 是 支付金额（参与积分的部分）
TradeTime DateTime 是 交易时间
McShopID long 否 该商户在猫酷系统中的唯一编号（与CrmShopID、DevShopID任其选一必填）
CrmShopID string 否 该商户在商场CRM系统中的唯一编号（与McShopID、DevShopID任其选一必填）
DevShopID string 否 该商户在本开发者中的唯一编号，若使用此编号，则需提前将商户对应编号导入猫酷系统（与McShopID、CrmShopID任其选一必填）
TradeSerialNo string 否 交易流水号（同一posid下，交易流水号必须不同）
PosID string 否 PosID
TotalAmount double 是 订单总金额=支付金额+优惠金额
PromotionAmount double 否 优惠金额，默认为0
ConsumePromotionList List<ConsumePromotion> 否 优惠明细列表
ConsumePayList List<ConsumePay> 否 支付明细列表
Remark string 否 备注
# ConsumePromotion
名称 数据类型 必填 说明
PromotionType enum 是 优惠类型 （详见优惠类型枚举字典）
RuleNo string 否 优惠规则编号
No double 否 优惠码
Amount double 是 优惠金额
Desc string 否 优惠说明
# ConsumePay
名称 数据类型 必填 说明
PayType enum 是 支付方式（详见支付方式枚举字典）
PayNo string 否 支付单号
Amount double 是 支付金额
# 调用示例
{
  "TransID": "e51c1c060eae48d8a3f85037eabb0841",
  "MallCardNo": "1000001",
  "PayAmount": 1000,
  "TradeTime": "2017-03-24 15:16:45",
  "McShopID": 100001,
  "CrmShopID": null,
  "DevShopID": null,
  "TradeSerialNo": "10001001",
  "PosID": "1",
  "TotalAmount":1000,
  "PromotionAmount":500,
  "Remark":"%e6%b5%8b%e8%af%95%e5%a4%87%e6%b3%a8",
  "ConsumePromotionList":[
        {
            "PromotionType":6,
            "RuleNo":"RNO123",
            "No":"No123456",
            "Desc":"Desc",
            "Amount":200
        },
        {
            "PromotionType":1,
            "RuleNo":"RNO123123",
            "No":"No123456789",
            "Desc":"Desc",
            "Amount":300
        }
    ],
  "ConsumePayList":[
        {
            "PayType":12,
            "Amount":200,
            "PayNo":"PNO123456"
        },
        {
            "PayType":6,
            "Amount":300,
            "PayNo":"PNO123456987"
        },
        {
            "PayType":1,
            "Amount":500,
            "PayNo":"PNO1234569874546"
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Data Json 是 返回数据（已积过分时，会返回错误，并告知积分操作时间）
Message string 是 返回状态描述
# Data
名称 数据类型 必填 说明
Score double 是 本次积分
CurScore double 是 当前总积分
OperateTime DateTime 是 操作时间
# 返回示例
{
  "Code": 1,
  "Data": 
  {
    "Score": 1000,
    "CurScore": 2000,
    "OperateTime": "2017-03-31 15:16:45",
  },
  "Message": "成功"
}
1
2
3
4
5
6
7
8
9
10



# 获取会员积分明细V2

TIP

根据手机号、卡号、OpenUserID 三选一获取会员积分明细列表

接口地址：https://openapi10.mallcoo.cn/User/Score/v2/Get/Records/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
Mobile string 是 用户手机号【与用户卡号 、OpenUserID 三选一】
MallCardNo string 是 用户卡号【与用户手机号、OpenUserID 三选一】
OpenUserID string 是 用户在当前【开发者账号+项目（集团）】下的唯一标识(相当于用户ID)【与用户手机号、用户卡号三选一】
PageSize int 否 每页数量（默认10）
PageIndex int 否 当前页码（默认1）
# 调用示例
{ 
	"Mobile": "15901996272",
	"PageSize": 10,
	"PageIndex": 1,
}
1
2
3
4
5

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Data Json 是 返回数据
Message string 是 返回状态描述
# Data
名称 数据类型 必填 说明
CurScore double 是 当前总积分
GetScoreRecordListModel List<ScoreDetailModel> 是 积分明细
# ScoreDetailModel
名称 数据类型 必填 说明
ScoreRecordID string 是 积分记录ID
ScoreType string 是 积分类型
Score double 是 本次积分
ScoreTime DateTime 否 积分时间
Desc string 否 描述
# 返回示例
{
	"Code": 1,
	"Data": {
		"CurScore": 12770.0,
		"ScoreDetailModel": [{
			"ScoreRecordID": "813316",
			"ScoreType": "积分抵线下消费",
			"Score": -10.0,
			"ScoreTime": "2019/07/11 17:00:53",
			"Desc": "积分抵线下消费"
		}]
	},
	"Message": "成功"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14



# 通过手机号扣减积分（线下消费积分抵扣）

TIP

通过手机号查询会员，扣减积分

接口地址：https://openapi10.mallcoo.cn/User/Score/V1/Consume/Subtract/ByMobile/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
TransID string 是 交易（事务）ID，当前应用下不得重复，保证提交的唯一性
Mobile string 是 手机号
Score int 是 扣减积分值（正整数）
SubtractTime DateTime 是 积分扣减时间（必填，建议用交易订单的订单发起时）
Deduction int 是 积分扣减方（1：商场；2：商户；当扣减方为商户时要传入商户ID）
McShopID long 否 该商户在猫酷系统中的唯一编号（当扣减方为商户时，与CrmShopID、DevShopID任其选一必填）
CrmShopID string 否 该商户在商场CRM系统中的唯一编号（当扣减方为商户时，与McShopID、DevShopID任其选一必填）
DevShopID string 否 该商户在本开发者中的唯一编号，若使用此编号，则需提前将商户对应编号导入猫酷系统（当扣减方为商户时，与McShopID、CrmShopID任其选一必填）
Reason string 否 积分变动原因 （注：请注意编码，编码格式为：UTF-8 (UrlEncode)）
# 调用示例

{
  "TransID": "67676554354520170527",
  "Mobile": "15901996272",
  "Score": 1000,
  "Deduction": 2,
  "SubtractTime": "2017-03-24 15:16:45",
  "McShopID": 100001,
  "CrmShopID": null,
  "DevShopID": null,
}
1
2
3
4
5
6
7
8
9
10
11
12

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Message string 是 返回状态描述
# 返回示例

{
  "Code": 1,
  "Message": "成功"
}
1
2
3
4
5
6



# 通过会员卡号扣减积分（线下消费积分抵扣）

TIP

通过会员卡号查询会员，扣减积分

接口地址：https://openapi10.mallcoo.cn/User/Score/V1/Consume/Subtract/ByMallCardNo/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
TransID string 是 交易（事务）ID，当前应用下不得重复，保证提交的唯一性
MallCardNo string 是 会员卡号
Score int 是 扣减积分值（正整数）
SubtractTime DateTime 是 积分扣减时间（必填，建议用交易订单的订单发起时）
Deduction int 是 积分扣减方（1：商场；2：商户；当扣减方为商户时要传入商户ID）
McShopID long 否 该商户在猫酷系统中的唯一编号（当扣减方为商户时，与CrmShopID、DevShopID任其选一必填）
CrmShopID string 否 该商户在商场CRM系统中的唯一编号（当扣减方为商户时，与McShopID、DevShopID任其选一必填）
DevShopID string 否 该商户在本开发者中的唯一编号，若使用此编号，则需提前将商户对应编号导入猫酷系统（当扣减方为商户时，与McShopID、CrmShopID任其选一必填）
Reason string 否 积分变动原因（注：请注意编码，编码格式为：UTF-8 (UrlEncode)）
# 调用示例

{
  "TransID": "67676554354520170527",
  "MallCardNo": "201610000343",
  "Score": 1000,
  "Deduction": 2,
  "SubtractTime": "2017-03-24 15:16:45",
  "McShopID": 100001,
  "CrmShopID": null,
  "DevShopID": null,
}
1
2
3
4
5
6
7
8
9
10
11
12

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Message string 是 返回状态描述
# 返回示例

{
  "Code": 1,
  "Message": "成功"
}
1
2
3
4
5
6



# 查询积分是否扣减成功

TIP

查询积分是否扣减成功

接口地址：https://openapi10.mallcoo.cn/User/Score/v1/Check/ByTransID (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
TransID string 是 交易（事务）ID
# 调用示例

{ 
	"TransID": "99",
}
1
2
3
4
5

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Message string 是 返回状态描述
# 返回示例

{
	"Code": 1,
	"Message": "成功"
}
1
2
3
4
5
6



# 查询商场/商户的积分扣减记录

TIP

查询该商户/本商场在此应用下的积分扣减记录

接口地址：https://openapi10.mallcoo.cn/User/Score/v1/Get/DeductScoreRecord (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
Deduction int 是 积分扣减方（1|商场，2|商户）
McShopID long 否 该商户在猫酷系统中的唯一编号（当扣减方为商户时，与CrmShopID、DevShopID任其选一必填）
CrmShopID string 否 该商户在商场CRM系统中的唯一编号（当扣减方为商户时，与McShopID、DevShopID任其选一必填）
DevShopID string 否 该商户在本开发者中的唯一编号，若使用此编号，则需提前将商户对应编号导入猫酷系统（当扣减方为商户时，与McShopID、CrmShopID任其选一必填）
PageSize int 否 每页数量（默认10）
PageIndex int 否 当前页码（默认1）
# 调用示例

{ 
	"Deduction": 2,
	"McShopID": 100001,
	"CrmShopID": null,
	"DevShopID": null,
	"PageSize": 10,
	"PageIndex": 1,
}
1
2
3
4
5
6
7
8
9
10

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Data Json 是 返回数据
Message string 是 返回状态描述
# Data
名称 数据类型 必填 说明
TransID string 是 交易（事务）ID
Mobile string 是 手机号
MallCardNo string 是 猫酷会员卡号
TradeTime DataTime 是 积分扣减时间
Score double 是 扣减积分值
# 返回示例

{
	"Code": 1,
	"Data": 
	  [
	      {
		"TransID": "99",
		"Mobile": "15901996272",
		"MallCardNo": "1000001",
		"TradeTime": "2016-08-25 00:00:00",
		"Score": 1000,
	      },
	  ],
	"Message": "成功"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16



# 根据手机号增加会员积分

TIP

必须使用【Mobile】来增加会员积分

接口地址：https://openapi10.mallcoo.cn/User/Score/v1/Plus/ByMobile/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
Mobile string 是 手机号
ScoreEvent enum 是 积分事件（详情看枚举字典）
Score double 是 需要增加的积分
Reason string 否 积分变动原因（注意：中文需要进行UTF-8 (UrlEncode)编码）
TransID string 是 事务ID（当前应用下不得重复，保证提交的唯一性）

# 调用示例


{ 
  "Mobile": "13641726191",
  "Score": 1,
  "TransID": "e51c1c060eae48d8a3f85037eabb0841",
  "ScoreEvent": 2000
}
1
2
3
4
5
6
7
8

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Message string 是 返回状态描述
# 返回示例

{
  "Code": 1,
  "Message": "成功"
}
1
2
3
4
5
6



# 根据手机号扣减会员积分

TIP

必须使用【Mobile】来扣除会员积分

接口地址：https://openapi10.mallcoo.cn/User/Score/v1/Subtract/ByMobile/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
Mobile string 是 手机号
ScoreEvent enum 是 积分事件（详情看枚举字典）
Score double 是 需要扣除的积分
Reason string 否 积分变动原因（注意：中文需要进行UTF-8 (UrlEncode)编码）
TransID string 是 事务ID（当前应用下不得重复，保证提交的唯一性）

# 调用示例


{ 
  "Mobile": "13641726191",
  "Score": 1,
  "TransID": "e51c1c060eae48d8a3f85037eabb0841",
  "ScoreEvent": 2000
}
1
2
3
4
5
6
7
8

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Message string 是 返回状态描述
# 返回示例

{
  "Code": 1,
  "Message": "成功"
}
1
2
3
4
5
6



# 根据会员卡号增加会员积分

TIP

必须使用【CardNo】来增加会员积分

接口地址：https://openapi10.mallcoo.cn/User/Score/v1/Plus/ByCardNo/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
CardNo string 是 会员卡号
ScoreEvent enum 是 积分事件（详情看枚举字典）
Score double 是 需要增加的积分
Reason string 否 积分变动原因（注意：中文需要进行UTF-8 (UrlEncode)编码）
TransID string 是 事务ID（当前应用下不得重复，保证提交的唯一性）

# 调用示例


{ 
  "CardNo": "201610000095",
  "Score": 1,
  "TransID": "e51c1c060eae48d8a3f85037eabb0841",
  "ScoreEvent": 2000
}
1
2
3
4
5
6
7
8

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Message string 是 返回状态描述
# 返回示例

{
  "Code": 1,
  "Message": "成功"
}
1
2
3
4
5
6



# 根据会员卡号扣减会员积分

TIP

必须使用【CardNo】来扣除会员积分

接口地址：https://openapi10.mallcoo.cn/User/Score/v1/Subtract/ByCardNo/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
CardNo string 是 会员卡号
ScoreEvent enum 是 积分事件（详情看枚举字典）
Score double 是 需要扣除的积分
Reason string 否 积分变动原因（注意：中文需要进行UTF-8 (UrlEncode)编码）
TransID string 是 事务ID（当前应用下不得重复，保证提交的唯一性）

# 调用示例


{ 
  "CardNo": "201610000095",
  "Score": 1,
  "TransID": "e51c1c060eae48d8a3f85037eabb0841",
  "ScoreEvent": 2000
}
1
2
3
4
5
6
7
8

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Message string 是 返回状态描述
# 返回示例

{
  "Code": 1,
  "Message": "成功"
}
1
2
3
4
5
6

# 查询会员即将清零积分

TIP

查询会员即将清零积分

接口地址：https://openapi10.mallcoo.cn/Score/v1/Get/UserExpiredBouns/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
Mobile string 否 手机号(与会员卡号二选一)
MallCardNo string 否 会员卡号(与手机号二选一)

# 调用示例


{ 
  "MallCardNo": "201610000095"
}
1
2
3
4
5

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Data Json 是 返回数据
Message string 是 返回状态描述
# Data
名称 数据类型 必填 说明
Bonus double 是 积分清零积分
ClearTime DateTime 是 积分到期时间（清零时间）
# 返回示例

{
	"Code": 1,
	"Data": {
		"Bonus": 100.0,
		"ClearTime": "2021/03/11 00:00:00"
	},
	"Message": "成功",
	"Extension": []
}
1
2
3
4
5
6
7
8
9
10
11
Last Updated: 2021/5/6 下午2:58:52

← 券 →