增减会员余额

增减会员余额

接口说明

该接口用于增减会员的本金余额和赠金余额；

注意事项

不支持减少会员的余额为负数，否则为返回错误，若因为异常原因，无法正确获取到增减余额是否成功，可以通过查询增加会员余额结果接口进行查询

基本信息

请求参数

请求头

content-type 必填 string
示例：application/json
固定值：application/json

参数

appid 必填 string
示例：10000000000
应用唯一标识，可以从众流生意app中的开放平台中获取

client_token 必填 string
示例：laOVEe3aNYY*****
用户授权令牌

vip_id 必填 string
示例：dnA0Q1V5bGdXbFFkaW5MOUdlQVY1dz09
会员id

out_trade_no 必填 string
示例：201622077045496
交易号，必须由数字组成，长度为15~20之间，且不可以重复，调用方需要保证每次唯一

balance_modify_recharge_balance_type_id 必填 int
示例：1
本金增减类型，1增加，2减少

balance_modify_give_balance_type_id 必填 int
示例：1
赠金增减类型，1增加，2减少

recharge_balance 必填 int
示例：100
需要操作的本金金额，必须为正数，配合上方类型使用，注意不是将余额修改为传入的金额，单位：分

give_balance 必填 int
示例：100
需要操作的赠金金额，必须为正数，配合上方类型使用，注意不是将余额修改为传入的金额，单位：分

remark 必填 string
示例：测试
备注，最多255个字符

请求示例

curl --location --request POST 'https://open.shenyi.pro/vip/v1/balance_modify \
--header 'Content-Type: application/json' \
--data '{
    "appid": "10000000000",
    "client_token": "laOVEe3aNYY*****",
    "vip_id": "dnA0Q1V5bGdXbFFkaW5MOUdlQVY1dz09",
    "out_trade_no": "201622077045496",
    "balance_modify_recharge_balance_type_id": 1,
    "balance_modify_give_balance_type_id": 1,
    "recharge_balance": 100,
    "give_balance": 100,
    "remark": "测试"
}'

响应参数

参数

code int
示例：200
请求响应

message string
示例：请求成功
请求响应

data struct
示例：true
请求响应

响应示例

{
    "code": 200,
    "message": "请求成功",
    "data": true
}