企迈云-开放平台

API 3.0

7 新会员

API 3.0 > 7.6 积分操作 > 7.6.2积分冲正

7.6.2积分冲正

开启令牌和权限后可调用。签名方式请查看开发指南

场景描述：根据扣减的业务标识去充正（返还积分）

零售餐饮

请求地址

请求方式	版本信息	请求地址
POST	V3	http://openapi.zvcms.com/v3/crm/points/reversePoints

公共参数

参数	参数类型	是否必填	描述
openId	string	是	密钥Id
grantCode	string	是	授权code
token	string	是	签名，参考《数字签名sign》
timestamp	string	是	当前时间戳
nonce	string	是	随机正整数
params	array	是	业务参数

请求参数

参数	参数类型	是否必填	描述
bizId	string	是	业务标识
changeType	int	是	冲正类型:3：增加冲正，4：扣减冲正
reason	string	是	原因
pointsChannel	int	是	积分来源渠道: 1-支付宝 ,2-微信, 3-pos, 4-美团, 5-饿了么, 6-有赞商城, 7-三方, 8-其他,9-口碑
sourceType	int	是	积分来源途径/方式:30 兑换取消,31-抵现取消 ,32-退单冲销
customerId	int	是	用户id

响应参数

参数	参数类型	描述

请求示例

{
    "openId": "6dc05b4ac175cf316d226252b05cf685",
    "grantCode": "782c281f62",
    "timestamp": "1547186244",
    "nonce": "658965",
    "token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "params": {
        "bizId": "",
        "changeType": "3",
        "reason": "",
        "pointsChannel": "7",
        "sourceType": "32",
        "customerId": ""
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": []
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}

请求地址

请求方式	版本信息	请求地址
POST	V3	http://openapi.zvcms.com/v3/crm/points/reversePoints

公共参数

参数	参数类型	是否必填	描述
openId	string	是	密钥Id
grantCode	string	是	授权code
token	string	是	签名，参考《数字签名sign》
timestamp	string	是	当前时间戳
nonce	string	是	随机正整数
params	array	是	业务参数

请求参数

参数	参数类型	是否必填	描述
bizId	string	是	业务标识
changeType	int	是	冲正类型:3：增加冲正，4：扣减冲正
reason	string	是	原因
pointsChannel	int	是	积分来源渠道: 1-支付宝 ,2-微信, 3-pos, 4-美团, 5-饿了么, 6-有赞商城, 7-三方, 8-其他,9-口碑
sourceType	int	是	积分来源途径/方式:30 兑换取消,31-抵现取消 ,32-退单冲销

响应参数

参数	参数类型	描述
status	int	请求成功或者失败
code	int	成功/错误编码(0:成功 30005：积分已冲正)
message	int	成功/错误描述

请求示例

{
    "openId": "6dc05b4ac175cf316d226252b05cf685",
    "grantCode": "782c281f62",
    "timestamp": "1547186244",
    "nonce": "658965",
    "token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "params": {
        "bizId": "",
        "changeType": "3",
        "reason": "",
        "pointsChannel": "7",
        "sourceType": "32"
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "status": "",
        "code": "",
        "message": ""
    }
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}