3.1.7会员商户优惠试算


通过上传订单金额、消费门店、会员唯一标识查询会员的可用权益、权益优惠金额、可用金额、积分、积分抵现最大金额、可用券明细。

接口方法:

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"

}


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