# 积分扣减
# 接口地址
/marketing/points/redeem
# 入参
# 字段说明
名称 | 类型 | 必填 | 示例 | 描述 |
---|---|---|---|---|
serialNo | String | 是 | "70712b42-54ba-4600-8b77-2134bf1439b2" | 流水号,需保证唯一,用来进行操作的幂等校验及问题定位。如果业务上提供不了唯一操作流水号,可以考虑使用 UUID.randomUUID().toString()随机生成 |
sourceType | Number | 是 | -3 | 来源类型/操作类型 -3:积分扣减 |
idCustomer | Number | 是 | 15944592175883362324 | 客户 ID |
points | Number | 是 | 99 | 积分值,只能为正数 |
tocRemark | String | 否 | 备注信息,会对 C 端透出展示 | |
tobRemark | String | 否 | 备注信息,只对 B 端透出展示 | |
idEmployee | Number | 是 | 10545360219000304622 | 操作员工 ID |
# JSON示例
{
"paramValues": [
{
"idCustomer": 15944592175883362324,
"serialNo": "70712b42-54ba-4600-8b77-2134bf1439b2",
"sourceType": -3,
"points": 99,
"idEmployee": 10545360219000304622
}
]
}
# 出参
# 字段说明
名称 | 类型 | 示例 | 描述 |
---|---|---|---|
result | Boolean | false | 积分充值结果,true 代表成功,false 代表失败 |
message | String | "idEmployee 操作员工未开通 SAAS 账号" | 积分充值结果的文本说明,一般只有充值失败时才返回 |
# JSON示例
{
"code": 200,
"message": "OK",
"data": {
"result": false,
"message": "idEmployee 操作员工未开通 SAAS 账号"
}
}