通过上传订单金额、消费门店、会员唯一标识查询会员的可用权益、权益优惠金额、可用金额、积分、积分抵现最大金额、可用券明细。
接口方法:
method: allinpay.shopoint.memberService.memberCalculate
version: 1.0
业务请求参数
字段名 |
参数类型 |
必填 |
最大长度 |
说明 |
取值 |
idType |
String |
是 |
|
会员账号类型 |
1-手机号 2-会员卡号 3-Openid 4-会员动态码 5-外部会员ID 6-内部会员ID |
memberId |
String |
是 |
|
会员账号 |
|
shopId |
String |
否 |
|
店铺ID |
输入则couponList只返回该店铺下的可用优惠券 |
shopCode |
String |
否 |
|
店铺号 |
与shopId功能相同,shopId和shopCode同时输入则只取shopId,二者必输一个 |
amount |
String |
是 |
|
订单金额 |
单位元:最多两位小数 |
amountOut |
String |
否 |
|
不参与优惠金额 |
|
queryType |
Integer |
是 |
|
查询账户范围 |
0全部、1余额、2积分、3券列表、4优惠金额,可组合“,”分隔 |
业务响应参数
字段名 |
参数类型 |
必填 |
最大长度 |
说明 |
取值 |
||
code |
Integer |
是 |
|
返回码 |
0:表示成功; 3:表示失败,具体失败原因参见msg字段; 其他:参见4.1 公共返回码 |
||
msg |
String |
是 |
|
错误信息 |
|
||
data |
discountAmount |
String |
否 |
|
优惠金额 |
单位: 元 |
|
balance |
String |
否 |
|
余额 |
单位:元 |
||
score |
String |
否 |
|
积分 |
|
||
allowScorePayment |
Boolean |
否 |
|
是否允许积分支付 |
|
||
scoreAmount |
String |
否 |
|
积分兑换的基数可兑换的金额 |
单位:元
|
||
scoreQuantity |
Integer |
否 |
|
积分兑换基数 |
|
||
couponList |
|
|
否 |
|
可用券列表 |
|
|
templateId |
Integer |
是 |
|
模板ID |
|
||
couponNo |
String |
是 |
|
券号 |
|
||
couponName |
String |
是 |
|
券名称 |
|
||
couponType |
String |
是 |
|
券类型 |
0 现金卡 1 代金券 2 计次券 3 满减活动券 |
||
unit |
String |
否 |
|
券单位 |
满减券有效 |
||
balance |
BigDecimal |
是 |
|
余额 |
|
||
validityBeginDate |
String |
是 |
|
有效期起始日期 |
|
||
validityEndDate |
String |
是 |
|
有效期终止日期 |
|
||
hasPassword |
Boolean |
是 |
|
卡是否有密码
|
true:有密码 false:无密码 |
||
unusableReason |
String |
否 |
|
不可用券原因 |
|
||
status |
Integer |
是 |
|
券状态 |
态,0 - 有效 1 - 冻结 2 - 已作废 3 - 已核销 100 - 待生成 |
||
rangeTiem |
String |
否 |
|
可用时间 |
不返回表示不限制,否则解析字符串获取设定规则 示例: 9:30~10:30,17:00~19:00 |
||
rangeDate |
Integer |
否 |
|
可用日期 |
不返回表示不限制,否则解析字符串获取设定。具体解析方法请参考SDK工具包中的DateUtils.getDatesInt方法。 |
||
rangeDayOfWeek |
Integer |
否 |
|
周几可用 |
不返回表示不限制,否则解析字符串获取设定。具体解析方法请参考SDK工具包中的DateUtils.getWeeksInt方法。 |
||
usableAmount |
BigDecimal |
否 |
|
每满多少金额可以使用1张 |
满减券使用 |
||
usableMaxNum |
Integer |
否 |
|
每笔订单最大优惠金额 |
满减券使用 |
||
instruction |
String |
否 |
|
券使用须知 |
|
请求示例
{"idType":"1","memberId":"13882177104"}
响应示例
{
"code": 0,
"data": {
"templateId": 794,
"couponNo": "10000000000001607134",
"couponName": "商品删除测试",
"couponType": 0,
"balance": 1,
"unit": null,
"rangeDate": 2102013412,
"rangeDayOfWeek": 42,
"rangeTime": “9:30~10:30,19:30~22:30”,
"validityType": null,
"validityBeginDate": [
2020,
4,
7,
0,
0
],
"validityEndDate": [
2020,
5,
7,
0,
0
]
},
"token": "QX1YbSPkNEbu5x1EDKzXDJtxy86sQnO6ExGe9nWs"
}