文档中心 > API类目 > 海南离岛免税api

qimen.alibaba.gdfc.points.update (积分增减基础服务)

直接操作用户的积分增减/增减的冲正操作

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
userId String 必须 1234567 用户id
outerUserId String 可选 123abc 外部用户id
opType String 必须 incr incr:增减积分,decr:减少积分
pointAmount Number 必须 55 积分数量,必须是整数
opReason String 可选 注册送积分 操作理由/描述
remark String 可选 备注 备注说明
orderCode String 可选 abc123 单据号/幂等号
traceId String 可选 123 123

响应参数

名称 类型 示例值 描述
pointAmount Number 15800 账户内剩余积分数量,整数
success Boolean true 操作成功标记
respCode String 400 异常code
respMsg String 系统异常 异常描述

请求示例

{"traceId":"123","pointAmount":55,"opReason":"注册送积分","opType":"incr","outerUserId":"123abc","remark":"备注","orderCode":"abc123","userId":"1234567"}

响应示例

{
    "pointAmount":15800,
    "success":true,
    "respCode":"400",
    "respMsg":"系统异常"
}

验签示例

{"success":"false","respMsg":"Illegal request","respCode":"sign-check-failure"}

错误码解释

错误码 错误描述 解决方案

API工具

FAQ

返回
顶部