# 额度变更相关接口

接口规范：

要求	备注
http-post格式

# 1.1 创建/更新授信额度

# 接口说明：

接口由宜信提供，合作方调用。
用于创建或修改用户的授信额度数据

# 接口地址：

/amount-center/api/v1/common/chanage/save

# 请求参数：

字段名	字段类型	是否必须	备注
appKey	String(50)	是	由额度中心分配
userId	Long	是	用户id
amount	Long	是	授信金额(单位分)
businessId	String(50)	是	业务方id 业务方自己的业务id,用于查询展示
serNo	String(50)	是	额度中心流水号每次请求额度中心必须唯一。业务幂等字段
expiredDate	String(10)	是	额度有效截止日期 yyyy-MM-dd。示例值2021-12-17
userAmountType	byte(0-127)	是	额度类型默认0-通用额度同一个用户可创建多个类型的额度由业务方自定义
reasonType	String(50)	否	变更原因传入文字描述，用于查询时展示
remark	String(50)	否	备注业务方预留字段,用于查询时展示
creditType	int	否	额度类型 0-定期定额 1-循环额度默认循环额度,示例值(1)
utmSource	String(50)	否	进件渠道业务方预留字段，用于查询时展示
sign	String	否	签名
timeStamp	Long	否	时间戳

# 响应参数：

字段名	字段类型	备注
status	String	返回状态码0000:成功状态,9999:失败
msg	String	返回提示
data	String	返回包装类

# 1.2 占用额度

# 接口说明：

接口由宜信提供，合作方调用。
占用的额度的总额需要小于等于授信额度。
占用额度后可用额度减小，占用额度增加。

# 接口地址：

/amount-center/api/v1/common/chanage/apply

# 请求参数：

字段名	字段类型	是否必须	备注
appKey	String(50)	是	由额度中心分配
userId	Long	是	用户id
amount	Long	是	占用额度(单位分)
businessId	String(50)	是	业务方id 业务方自己的业务id,用于查询展示
serNo	String(50)	是	额度中心流水号每次请求额度中心必须唯一。业务幂等字段
userAmountType	byte(0-127)	是	额度类型默认0-通用额度同一个用户可创建多个类型的额度由业务方自定义
reasonType	String(50)	否	变更原因传入文字描述，用于查询时展示
remark	String(50)	否	备注业务方预留字段,用于查询时展示
creditType	int	否	额度类型 0-定期定额 1-循环额度默认循环额度,示例值(1)
utmSource	String(50)	否	进件渠道业务方预留字段，用于查询时展示
sign	String	否	签名
timeStamp	Long	否	时间戳

# 响应参数：

字段名	字段类型	备注
status	String	返回状态码0000:成功状态,9999:失败
msg	String	返回提示
data	String	返回包装类

# 1.3 使用额度

# 接口说明：

接口由宜信提供，合作方调用。
需占用额度后才可调用此接口。使用的额度需要小于等于已占用的额度
占用额度减小，已使用额度增加

# 接口地址：

/amount-center/api/v1/common/chanage/use

# 请求参数：

字段名	字段类型	是否必须	备注
appKey	String(50)	是	由额度中心分配
userId	Long	是	用户id
amount	Long	是	使用额度(单位分)
businessId	String(50)	是	业务方id 业务方自己的业务id,用于查询展示
serNo	String(50)	是	额度中心流水号每次请求额度中心必须唯一。业务幂等字段
userAmountType	byte(0-127)	是	额度类型默认0-通用额度同一个用户可创建多个类型的额度由业务方自定义
reasonType	String(50)	否	变更原因传入文字描述，用于查询时展示
remark	String(50)	否	备注业务方预留字段,用于查询时展示
creditType	int	否	额度类型 0-定期定额 1-循环额度默认循环额度,示例值(1)
utmSource	String(50)	否	进件渠道业务方预留字段，用于查询时展示
sign	String	否	签名
timeStamp	Long	否	时间戳

# 响应参数：

字段名	字段类型	备注
status	String	返回状态码0000:成功状态,9999:失败
msg	String	返回提示
data	String	返回包装类

# 1.4 恢复已占用的额度

# 接口说明：

接口由合作方提供，宜信方调用。
用于恢复用户的占用额度，占用的额度减小，可用额度增加

# 接口地址：

# 请求参数：

字段名	字段类型	是否必须	备注
appKey	String(50)	是	由额度中心分配
userId	Long	是	用户id
amount	Long	是	占用额度减小的值(单位分)
businessId	String(50)	是	业务方id 业务方自己的业务id,用于查询展示
serNo	String(50)	是	额度中心流水号每次请求额度中心必须唯一。业务幂等字段
userAmountType	byte(0-127)	是	额度类型默认0-通用额度同一个用户可创建多个类型的额度由业务方自定义
reasonType	String(50)	否	变更原因传入文字描述，用于查询时展示
remark	String(50)	否	备注业务方预留字段,用于查询时展示
creditType	int	否	额度类型 0-定期定额 1-循环额度默认循环额度,示例值(1)
utmSource	String(50)	否	进件渠道业务方预留字段，用于查询时展示
sign	String	否	签名
timeStamp	Long	否	时间戳

# 响应参数：

字段名	字段类型	备注
status	String	返回状态码0000:成功状态,9999:失败
msg	String	返回提示
data	String	返回包装类

# 1.5 恢复已使用的额度

# 接口说明：

接口由合作方提供，宜信方调用。
用于恢复用户的已使用额度，已使用额度减小，可用额度增加

# 接口地址：

/amount-center/api/v1/common/chanage/use-recover

# 请求参数：

字段名	字段类型	是否必须	备注
appKey	String(50)	是	由额度中心分配
userId	Long	是	用户id
amount	Long	是	占用额度减小的值(单位分)
businessId	String(50)	是	业务方id 业务方自己的业务id,用于查询展示
serNo	String(50)	是	额度中心流水号每次请求额度中心必须唯一。业务幂等字段
userAmountType	byte(0-127)	是	额度类型默认0-通用额度同一个用户可创建多个类型的额度由业务方自定义
reasonType	String(50)	否	变更原因传入文字描述，用于查询时展示
remark	String(50)	否	备注业务方预留字段,用于查询时展示
creditType	int	否	额度类型 0-定期定额 1-循环额度默认循环额度,示例值(1)
utmSource	String(50)	否	进件渠道业务方预留字段，用于查询时展示
sign	String	否	签名
timeStamp	Long	否	时间戳

# 响应参数：

字段名	字段类型	备注
status	String	返回状态码0000:成功状态,9999:失败
msg	String	返回提示
data	String	返回包装类

# 1.6 冻结额度

# 接口说明：

接口由合作方提供，宜信方调用。
用于冻结用户额度,需要指定冻结日期

# 接口地址：

/amount-center/api/v1/common/chanage/frozen

# 请求参数：

字段名	字段类型	是否必须	备注
appKey	String(50)	是	由额度中心分配
userId	Long	是	用户id
frozenExpireDate	String(10)	是	额度冻结截止日期 yyyy-MM-dd。示例值2021-12-17
frozenReason	byte	是	冻结原因字典
businessId	String(50)	是	业务方id 业务方自己的业务id,用于查询展示
serNo	String(50)	是	额度中心流水号每次请求额度中心必须唯一。业务幂等字段
userAmountType	byte(0-127)	是	额度类型默认0-通用额度同一个用户可创建多个类型的额度由业务方自定义
reasonType	String(50)	否	变更原因传入文字描述，用于查询时展示
remark	String(50)	否	备注业务方预留字段,用于查询时展示
creditType	int	否	额度类型 0-定期定额 1-循环额度默认循环额度,示例值(1)
utmSource	String(50)	否	进件渠道业务方预留字段，用于查询时展示
sign	String	否	签名
timeStamp	Long	否	时间戳

# 响应参数：

字段名	字段类型	备注
status	String	返回状态码0000:成功状态,9999:失败
msg	String	返回提示
data	String	返回包装类

# 字典冻结原因

码值	描述
1	二次风控普通冻结
2	逾期冻结
3	face_recog_fail
4	大额风控弱拒贷
5	小米剔除白名单用户
6	二次风控拒贷冻结
7	手动冻结例如：风控要求紧急冻结等

# 1.7 解冻结额度

# 接口说明：

接口由合作方提供，宜信方调用。
用于解冻结用户额度

# 接口地址：

/amount-center/api/v1/common/chanage/un-frozen

# 请求参数：

字段名	字段类型	是否必须	备注
appKey	String(50)	是	由额度中心分配
userId	Long	是	用户id
businessId	String(50)	是	业务方id 业务方自己的业务id,用于查询展示
serNo	String(50)	是	额度中心流水号每次请求额度中心必须唯一。业务幂等字段
userAmountType	byte(0-127)	是	额度类型默认0-通用额度同一个用户可创建多个类型的额度由业务方自定义
reasonType	String(50)	否	变更原因传入文字描述，用于查询时展示
remark	String(50)	否	备注业务方预留字段,用于查询时展示
creditType	int	否	额度类型 0-定期定额 1-循环额度默认循环额度,示例值(1)
utmSource	String(50)	否	进件渠道业务方预留字段，用于查询时展示
sign	String	否	签名
timeStamp	Long	否	时间戳

# 响应参数：

字段名	字段类型	备注
status	String	返回状态码0000:成功状态,9999:失败
msg	String	返回提示
data	String	返回包装类

# 1.8 更新额度过期时间

# 接口说明：

接口由合作方提供，宜信方调用。
更新额度的有效期

# 接口地址：

/amount-center/api/v1/common/chanage/expire-time/update

# 请求参数：

字段名	字段类型	是否必须	备注
appKey	String(50)	是	由额度中心分配
userId	Long	是	用户id
expiredDate	String(10)	是	额度有效截止日期 yyyy-MM-dd。示例值2021-12-17
businessId	String(50)	是	业务方id 业务方自己的业务id,用于查询展示
serNo	String(50)	是	额度中心流水号每次请求额度中心必须唯一。业务幂等字段
userAmountType	byte(0-127)	是	额度类型默认0-通用额度同一个用户可创建多个类型的额度由业务方自定义
reasonType	String(50)	否	变更原因传入文字描述，用于查询时展示
remark	String(50)	否	备注业务方预留字段,用于查询时展示
creditType	int	否	额度类型 0-定期定额 1-循环额度默认循环额度,示例值(1)
utmSource	String(50)	否	进件渠道业务方预留字段，用于查询时展示
sign	String	否	签名
timeStamp	Long	否	时间戳

# 响应参数：

字段名	字段类型	备注
status	String	返回状态码0000:成功状态,9999:失败
msg	String	返回提示
data	String	返回包装类

← 接口说明额度查询相关接口 →

# 额度变更相关接口

# 1.1 创建/更新授信额度

# 接口说明：

# 接口地址：

# 请求参数：

# 响应参数：

# 1.2 占用额度

# 接口说明：

# 接口地址：

# 请求参数：

# 响应参数：

# 1.3 使用额度

# 接口说明：

# 接口地址：

# 请求参数：

# 响应参数：

# 1.4 恢复已占用的额度

# 接口说明：

# 接口地址：

# 请求参数：

# 响应参数：

# 1.5 恢复已使用的额度

# 接口说明：

# 接口地址：

# 请求参数：

# 响应参数：

# 1.6 冻结额度

# 接口说明：

# 接口地址：

# 请求参数：

# 响应参数：

# 字典 冻结原因

# 1.7 解冻结额度

# 接口说明：

# 接口地址：

# 请求参数：

# 响应参数：

# 1.8 更新额度过期时间

# 接口说明：

# 接口地址：

# 请求参数：

# 响应参数：

# 字典冻结原因