3.2.29第三方核券接口


allinpay.shopoint.thirdCouponService.consume

version: 1.0

业务请求参数

字段名

参数类型

必填

最大长度

说明

取值

type

 

 

String

是

 

类型

1.meituan

2.tiktok

3. dianping

mtdz

orderId

 

String

是

 

订单id

 

couponNo

 

 

String

是

 

券号

 

num

 

Integer

是

 

核销数量

 

shopId

 

Integer

否

 

店铺号

与shopCode二选一必填

shopCode

 

String

否

 

店铺编号

与shopId二选一必填

operUserId

 

String

是

 

核销人账号

操作人登录账号

remark

 

 

Integer

否

 

核销备注

 

tiktokCertificateList

 

List

否

 

抖音券指定核销列表

 

certificateId

String

是

 

抖音券id

 

num

Integer

是

 

核销数量

仅次卡有该字段

 

业务响应参数

字段名

参数类型

必填

最大长度

说明

取值

code

Integer

是

 

返回码

0:表示成功;

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

其他:参见4.1 公共返回码

msg

String

是

 

错误信息

 

data

tranNo

 

 

String

是

 

流水号

 

couponNo

 

 

String

是

 

券号

 

couponName

 

 

String

否

 

券名称

 

couponValue

 

 

Bigdecimal

否

 

券市场价

单位:元

couponBuyPrice

 

 

Bigdecimal

否

 

券售价

单位:元

changeSource

 

 

Integer

是

 

核销来源

42-接口核销

remark

 

 

String

否

 

核销备注

 

consumeTime

 

 

DateTime

是

 

核销时间

yyyy-MM-dd HH:mm:ss

originMtdz

 

 

String

否

 

美团到综的报文

 

originMtcy

 

 

String

否

 

美团餐饮的报文

 

originTiktok

 

 

String

否

 

抖音的报文

 

mtdz

 

List

 

 

美团到店综券才返回

 

receiptCode

 

String

 

 

验证券码

 

platformAmount

 

Bigdecimal

 

 

补贴金额(平台分摊)

单位:元

merchantAmount

 

Bigdecimal

 

 

补贴金额(商户分摊)

单位:元

couponDetails

couponNo

 

 

 

 

 

 

templateId

 

 

 

 

 

 

financeList

accountNo

String

 

 

科目编码

 

accountTitle

String

 

 

科目名称

 

accountPriority

Integer

 

 

科目优先级

 

accountValue

Bigdecimal

 

 

科目值

单位:元

apportSetId

Integer

 

 

科目ID

 

 

请求示例

{"type":"meituan","couponNo":"77012321150807","shopId":"147","orderId":"2023121901B","operUserId":"liangqi","remark":"我是备注"}

响应示例

{

"code": 0,

"data": {

"tranNo": "165416131313",

"couponNo":"77012321150807",

"couponName": "券名称",

"changeSource": "42",

"couponPrice": "0.1",

"couponBuyPrice": "0.1",

"remark":"我是备注",

"consumeTime":"2024-05-11 23:59:59"

}

}


2025年12月3日 14:12 收藏文档