通过上传订单金额、消费门店、会员唯一标识查询会员在第三方机构的可用权益、权益优惠金额、可用券明细。
接口方法:
method: allinpay.shopoint.memberService.memberCalculateWithinCollaborator
version: 1.0
业务请求参数
字段名 |
参数类型 |
必填 |
说明 |
取值 |
idType |
String |
是 |
会员账号类型 |
1手机号 2会员卡号 3-Openid 4-会员动态码 5-外部会员ID 6-内部会员ID 7-会员唯一ID |
memberId |
String |
是 |
会员账号 |
|
amount |
String |
是 |
订单金额 |
单位元:最多两位小数 |
amountOut |
String |
否 |
不参与优惠金额 |
|
shopId |
String |
否 |
店铺ID |
输入则返回店铺参与的活动 同时输入则只取shopId 如果都不输入,则活动设置时必须涵盖该机构所有店铺才能带出该活动 |
shopCode |
String |
否 |
店铺号 |
|
queryType |
Integer |
是 |
查询账户范围 |
0全部、1余额、2积分、3券列表、4优惠金额,可组合“,”分隔 |
业务响应参数
字段名 |
参数类型 |
必填 |
说明 |
取值 |
|||||
code |
Integer |
是 |
返回码 |
0:表示成功; 3:表示失败,具体失败原因参见msg字段; 其他:参见4.1 公共返回码 |
|||||
msg |
String |
是 |
错误信息 |
|
|||||
Data
|
collaboratorOrgs |
collaboratorOrgId |
Integer |
是 |
第三方机构ID |
|
|||
collaboratorOrgName |
String |
是 |
第三方机构名 |
|
|||||
collaboratorOrgLogo |
String |
否 |
第三方机构logo地址 |
|
|||||
promotions |
discountAmount |
BigDecimal |
否 |
仅为打折满减活动优惠金额。 券活动优惠金额见:couponDiscounts.discountAmount |
单位: 元 |
||||
promotionId |
Integer |
是 |
活动ID |
|
|||||
promotionName |
String |
是 |
活动名称 |
|
|||||
promotionType |
Integer |
是 |
活动类型 |
10,银行返券 11,银行打折 12,银行满减 13,银行领券 14,银行售券 20,银联礼券 21,微信打折 22,微信满减 23,微信领券 31,云闪付打折 32,云闪付满减
|
|||||
instruction |
String |
否 |
活动说明 |
|
|||||
couponDiscounts |
couponTemplateId |
Integer |
否 |
卡券模板Id |
|
||||
|
couponName |
String |
否 |
卡券名称 |
|
||||
|
discountAmount |
BigDecimal |
否 |
优惠金额 |
|
||||
|
count |
Integer |
否 |
可使用数量 |
|
||||
|
coupons |
couponNo |
String |
否 |
券号 |
|
|||
couponId |
Integer |
否 |
券ID |
|
|||||
couponType |
Integer |
否 |
券类型 |
0 现金卡 1 代金券 3 满减券 |
|||||
unit |
String |
否 |
券单位 |
满减券有效 |
|||||
balance |
BigDecimal |
否 |
券余额 |
|
|||||
validityBeginDate |
String |
是 |
有效期起始日期 |
|
|||||
validityEndDate |
String |
是 |
有效期终止日期 |
|
|||||
hasPassword |
Boolean |
是 |
卡是否有密码
|
true:有密码 false:无密码 |
|||||
unusableReason |
String |
否 |
不可用券原因 |
|
|||||
status |
Integer |
是 |
券状态 |
态,0 - 有效 1 - 冻结 2 - 已作废 3 - 已核销 100 - 待生成 |
|||||
rangeTime |
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":"13880702997","amount":"100","amountOut":"","shopId":"147","queryType":"0"}
响应示例
{
"code": "0",
"data":"{"collaboratorOrgs":[{"promotions":[{"promotionName":
"内部积分抵扣0707","promotionType":16,"couponDiscounts":[],"discountAmount":0.00},{"promotionName":"8.10积分抵扣活动","promotionType":16,"couponDiscounts":[],"discountAmount":0.00}],"collaboratorOrgName":"通惠商城","collaboratorOrgId":100152}]}",
"sign": "fdTb1ooBwATzTo1o3AB6shhJcCToqIDsrPQF3J1dTXLHW+YL8PPLZ8f6kohCu4w3Y2njlvOH/9CrU4G/sEVdylmuwr77JRGNMgKku29XvX6rihR/eMrLP3Wok9yfF6oukSpuRFpGeB6hoyHE+y+vn4JlK0u6vSNa/ywvCKBDYks="
}