3.2.27卡/券核销


根据卡号或券号或动态码核销卡或者券。

method: allinpay.shopoint.couponService.couponConsumeV1

version: 1.0

 

业务请求参数

字段名

参数类型

必填

最大长度

说明

取值

shopId

 

String

否

 

店铺ID

 

shopCode

 

String

否

 

店铺号

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

operUserId

 

String

是

 

收银员id

收银员登录名称

orderId

 

String

是

 

外部核券订单号

 

couponConsumeList

 

 

是

 

验卡/券列表

 

 

couponNo

String

是

 

卡号或券号或券动态码

 

consumeAmount

String

是

 

核销次数

计次卡(券)类单位为:次

passwd

String

否

 

密码,核销卡时与cidao至少填一项

券动态码及没密码时可为””

加密传输(详见2.3.4)

cidao

String

否

 

磁道信息, 核销卡时与passwd至少填一项

 

principalAmt

Decimal

否

 

本金

单位为元

remark

String

否

 

备注

 

stlmShopList

List

否

 

结算店铺信息

 

stlmShopId

Integer

否

 

结算店铺id

 

stlmShopCode

String

否

 

结算店铺号

 

stlmAmount

Decimal

否

 

结算金额, 单位元

 

 

业务响应参数

字段名

参数类型

必填

最大长度

说明

取值

code

Integer

是

 

返回码

0:表示成功;

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

其他:参见4.1 公共返回码

msg

String

是

 

错误信息

 

data

orgName

 

 

String

是

 

机构/商户名称

 

tranNo

 

 

String

是

 

交易流水号

 

couponConsumeDetail

 

 

List

是

 

验券交易详情

 

couponNo

 

String

是

 

券号

 

financeList

 

List

是

 

财务科目列表

 

accountNo

String

是

 

财务科目号

 

accountTitle

String

是

 

财务科目名称

 

accountPriority

Integer

是

 

财务科目优先级

 

accountValue

BigDecimal

是

 

科目值

科目值根据算法自动算出金额

 

请求示例

{"shopId":"1","operUserId":"1","couponConsumeList":[{"couponNo":"10000000010000055943","consumeAmount":"1","remark":"哈哈"}]}

响应示例

{

    "code": 0,

    "data": true,

    "sign": "VCpfqwnJGQvV5c3esmz5OpylgfIE6gGqtl3gS/Lrjz4dFt3icgeDA4yjZ9ZO+qJbGH85djwWp6EtTPPE/LRgI2TjWgiyuyR4FdJ7lM4ze/VwcAKxxWVj0OayjXLJblHxTtUNNjfzjH0ndnldQO7gigpvOfgMoampnbOq65SC+3o="

}


2025年11月18日 14:34 收藏文档