支持现金卡, 计次卡, 电子券调账。
method: allinpay.shopoint.couponService.cardAdjust
version: 1.0
业务请求参数
字段名 |
字段名 |
参数类型 |
必填 |
最大长度 |
说明 |
取值 |
orderId |
|
String |
是 |
60 |
外部调账订单号 |
|
adjustType |
|
Integer |
是 |
11 |
调账类型 |
0-现金卡 2-计次卡 |
cardAdjustList |
|
List |
是 |
|
调账列表 |
|
cardNo |
String |
是 |
32 |
实体卡卡号 |
|
|
value |
String |
是 |
11 |
调账数量 |
现金卡调账:单位元,2位小数 计次调账:单位次,正数 |
业务响应参数
字段名 |
参数类型 |
必填 |
最大长度 |
说明 |
取值 |
||
code |
Integer |
是 |
|
返回码 |
0:表示成功; 3:表示失败,具体失败原因参见msg字段; 其他:参见4.1 公共返回码 |
||
msg |
String |
否 |
|
错误信息 |
|
||
data |
records |
List |
是 |
|
调账明细列表 |
|
|
|
adjustType |
Integer |
是 |
|
调账类型 |
0-现金卡 2-计次卡 |
|
cardNo |
String |
是 |
|
实体卡卡号 |
|
||
couponName |
String |
是 |
|
券名称 |
|
||
balanceChanged |
BigDecimal |
是 |
|
调账数量(对应调账接口的value) |
单位元-现金卡 单位次-计次卡 |
||
initAmount |
BigDecimal |
是 |
|
初始面额 |
单位元-现金卡 单位次-计次卡 |
||
balance |
BigDecimal |
是 |
|
调账后余额 |
单位元-现金卡 单位次-计次卡 |
||
validityBeginDate |
String |
是 |
|
有效期起始日期 |
|
||
validityEndDate |
String |
是 |
|
有效期截止日期 |
|
||
adjustStatus |
Integer |
是 |
|
处理状态 |
0-待处理 1-处理成功 2-处理失败 3-审核拒绝 |
||
adjustStatusDesc |
String |
是 |
|
处理状态描述 |
0-待处理 1-处理成功 2-处理失败 3-审核拒绝 |
||
failDesc |
String |
否 |
|
失败原因 |
|
||
adjustTime |
String |
是 |
|
充值时间 |
时间格式:yyyy-dd-MM HH:mm:ss |
||
requestor |
String’ |
是 |
|
操作员(调账申请人) |
接口调账为:接口导入 |
||
auditor |
String |
是 |
|
调账审批人 |
请求示例
{"orderId":"20210914001","adjustType":"0","cardAdjustList":[{"cardNo":"202105120000001","value":"6"}]}
响应示例
{
"code": "0",
"data": "[{"couponName":"金额券0元0512001","adjustStatus":1,"auditor":"接口导入","adjustTime":"2021-09-14 10:02:14","cardNo":"202105120000001","validityEndDate":"2021-09-30 23:59:59","requestor":"接口导入","adjustType":0,"validityBeginDate":"2021-05-12 00:00:00","balance":6.00,"adjustStatusDesc":"处理成功","initAmount":0,"balanceChanged":6.0000}]",
"sign": "cS/NJZo1+eUyLdeFzeFj8ZpiZtYL6R+lbMuSqYGVPaAuikHIx71UGkq0KdOxKFYctBRTjFG9s85GGSf7oq1BjIsUYoVUC+9nNANfGgF1UpzRngkyD0PBboCiM0v0zvd4pP3ishKhprSXdupNfREUwYjWq5NLO9F9gWf7tXK/7sA="
}