3.1.32会员消费


依据会员标识消费会员积分、会员余额。支持卡/券列表消费(计次券)。

method: allinpay.shopoint.memberService.consumeV3

version: 1.0

业务请求参数

字段名

参数类型

必填

最大长度

说明

取值

idType

String

是

1

会员账号类型

1- 手机号

2- 会员卡号

4- 会员动态码

5- 外部会员ID

memberId

String

是

180

会员账号

 

balance

String

否

16

消费余额

单位元,大于0,可保留小数点后2位

balanceRemark

String

否

255

消费余额备注

消费余额大于0时有效

balancePrincipalAmt

Decimal

否

 

本金,单位为元

 

balanceStlmShopAmtList

List

否

 

分账列表

 

 

stlmShopId

Integer

否

 

店铺id

与店铺编号二选一必填

stlmShopCode

String

否

 

店铺编号

与店铺id二选一必填

stlmAmount

Decimal

是

 

单位为元

 

scores

String

否

11

消费积分

正整数

scoreRemark

String

否

11

消费积分备注

消费积分大于0时有效

shopId

String

否

11

店铺ID

 

shopCode

String

否

20

店铺号

与shopId功能相同,shopId和shopCode同时输入则只取shopId,shopId和shopCode必输一项

operUserId

String

是

30

收银员

收银员登录名称

passwd

String

否

128

支付密码

手机号、会员卡消费时必输,加密传输(详见2.3.4)

orderId

String

是

60

外部消费订单号

 

couponConsumeList

List

否

 

验券列表

 

couponNo

String

是

32

券号或券动态码

 

consumeAmount

String

是

13

核销次数

计次卡类单位为:次

passwd

String

否

128

密码

 

remark

String

否

255

备注

 

principalAmt

Decimal

否

 

本金

单位为元

stlmShopList

List

否

 

结算店铺信息

 

stlmShopId

Integer

否

 

结算店铺id

 

stlmShopCode

String

否

 

结算店铺号

 

stlmAmount

Decimal

否

 

结算金额, 单位元

 

业务响应参数

字段名

参数类型

必填

最大长度

说明

取值

code

Integer

是

4

返回码

0:表示成功;

3:表示失败,具体失败原因参见msg字段;

其他:参见4.1 公共返回码

msg

String

是

200

错误信息

 

data

respId

Integer

是

9

平台处理编号

 

 

finApports

数组

否

 

 

 

 

 

couponNo

String

 

32

 

 

 

 

apports

数组

 

 

 

 

 

 

 

apportCode

String

否

20

财务分摊编号

 

 

 

 

apportName

String

否

20

分摊描述

 

 

 

 

amount

BigDecimal

否

16

分摊金额

 

 

 

 

priority

Integer

否

10

优先级

 

 

请求示例

{"idType":"1","memberId":"13882177104","consumeType":"1","amount":"0.1","passwd":" 6E5C47F095BB6DC3308A89514A7206C8","shopId":"1"}

响应示例

{

    "code": 0,

"data": {

    "finApports": [

        {

            "couponNo": "1239328402892",

            "apports": [

                {

                    "apportCode": "CW235",

                    "apportName": "金额券固定分摊",

                    "priority": 1,

                    "amount": 23.00

                }

            ]

        }

    ]

},

    "token": "QX1YbSPkNEbu5x1EDKzXDJtxy86sQnO6ExGe9nWs"

}


2025年11月18日 11:53 收藏文档