依据会员标识消费会员积分、会员余额。支持卡/券列表消费(计次券)。
method: allinpay.shopoint.memberService.consumeV3
version: 1.0
业务请求参数
字段名 |
参数类型 |
必填 |
最大长度 |
说明 |
取值 |
||||
idType |
String |
是 |
1 |
会员账号类型 |
1- 手机号 2- 会员卡号 4- 会员动态码 5- 外部会员ID |
||||
memberId |
String |
是 |
180 |
会员账号 |
|
||||
balance |
String |
否 |
16 |
消费余额 |
单位元,大于0,可保留小数点后2位 |
||||
balanceRemark |
String |
否 |
255 |
消费余额备注 |
消费余额大于0时有效 |
||||
scores |
String |
否 |
11 |
消费积分 |
正整数 |
||||
scoreRemark |
String |
否 |
11 |
消费积分备注 |
消费积分大于0时有效 |
||||
shopId |
String |
否 |
11 |
店铺ID |
|
||||
shopCode |
String |
否 |
20 |
店铺号 |
与shopId功能相同,shopId和shopCode同时输入则只取shopId,shopId和shopCode必输一项 |
||||
operUserId |
String |
是 |
30 |
收银员 |
收银员登录名称 |
||||
passwd |
String |
否 |
128 |
支付密码 |
手机号、会员卡消费时必输,加密传输(详见2.3.4) |
||||
orderId |
String |
是 |
60 |
外部消费订单号 |
|
||||
couponConsumeList |
List |
否 |
|
验券列表 |
|
||||
couponNo |
String |
是 |
32 |
券号或券动态码 |
|
||||
consumeAmount |
String |
是 |
13 |
核销次数 |
计次卡类单位为:次 |
||||
passwd |
String |
否 |
128 |
密码 |
|
||||
remark |
String |
否 |
255 |
备注 |
|
||||
principalAmt |
Decimal |
否 |
|
本金 |
单位为元 |
||||
stlmShopList |
List |
否 |
|
结算店铺信息 |
|
||||
stlmShopId |
Integer |
否 |
|
结算店铺id |
|
||||
stlmShopCode |
String |
否 |
|
结算店铺号 |
|
||||
stlmAmount |
Decimal |
否 |
|
结算金额, 单位元 |
|
业务响应参数
字段名 |
参数类型 |
必填 |
最大长度 |
说明 |
取值 |
|||
code |
Integer |
是 |
4 |
返回码 |
0:表示成功; 3:表示失败,具体失败原因参见msg字段; 其他:参见4.1 公共返回码 |
|||
msg |
String |
是 |
200 |
错误信息 |
|
|||
data |
respId |
Integer |
是 |
9 |
平台处理编号 |
|
||
|
finApports |
数组 |
否 |
|
|
|
||
|
|
couponNo |
String |
|
32 |
|
|
|
|
|
apports |
数组 |
|
|
|
|
|
|
|
|
apportCode |
String |
否 |
20 |
财务分摊编号 |
|
|
|
|
apportName |
String |
否 |
20 |
分摊描述 |
|
|
|
|
amount |
BigDecimal |
否 |
16 |
分摊金额 |
|
|
|
|
priority |
Integer |
否 |
10 |
优先级 |
|
请求示例
{"idType":"1","memberId":"13882177104","consumeType":"1","amount":"0.1","passwd":" 6E5C47F095BB6DC3308A89514A7206C8","shopId":"1"}
响应示例
{
"code": 0,
"data": {
"finApports": [
{
"couponNo": "1239328402892",
"apports": [
{
"apportCode": "CW235",
"apportName": "金额券固定分摊",
"priority": 1,
"amount": 23.00
}
]
}
]
},
"token": "QX1YbSPkNEbu5x1EDKzXDJtxy86sQnO6ExGe9nWs"
}