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

}

 


2026年3月2日 15:09 收藏文档