3.1.13第三方优惠试算


通过上传订单金额、消费门店、会员唯一标识查询会员在第三方机构的可用权益、权益优惠金额、可用券明细。

接口方法:

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="

}

 


卜子超buzc 2025年5月14日 16:21 收藏文档