3.2.28第三方核券准备接口


allinpay.shopoint.thirdCouponService.prepare

version: 1.0

 

业务请求参数

字段名

参数类型

必填

最大长度

说明

取值

type

 

 

String

 

类型

meituan

tiktok

dianping  mtdz

couponNo

 

 

String

 

券号

 

shopId

 

Integer

 

店铺号

与shopCode二选一必填

shopCode

 

String

 

店铺编号

与shopId二选一必填

 

业务响应参数

字段名

参数类型

必填

最大长度

说明

取值

code

Integer

 

返回码

0:表示成功;

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

其他:参见4.1 公共返回码

msg

String

 

错误信息

 

data

 

couponName

 

 

 

String

 

 

券名称

 

couponValue

 

 

 

String

 

 

券市场价

单位:元

couponBuyPrice

 

 

String

 

 

券售价

单位:元

couponType

 

 

 

String

 

 

券类型

 

initAmount

 

 

 

Integer

 

 

券面额

券可验证数量

validityBeginDate

 

 

 

String

 

 

有效开始时间

yyyy-MM-dd HH:mm:ss

validityEndDate

 

 

 

String

 

 

有效截止时间

yyyy-MM-dd HH:mm:ss

couponTemplateList

 

 

 

 

 

 

 

 

templateId

 

 

 

 

 

数字营销券模版id

 

couponType

 

 

 

 

 

数字营销券类型

0-金额券

2-计次券

3-满减券

meiTuan

 

 

 

 

 

美团券才返回

 

dealBeginTime

 

String

 

 

 

项目开始时间

yyyy-MM-dd

dealId

 

Integer

 

 

项目ID

 

dealValue

 

Bigdecimal

 

 

券面值/市场价

单位:元

dealTitle

 

String

 

 

项目名称

 

count

 

Integer

 

 

最大可验证张数

 

singleValue

 

Bigdecimal

 

 

量贩项目的单张券原价

单位:元

dealPrice

 

Bigdecimal

 

 

团购券价格

单位:元

dianPing
mtdz

 

 

 

 

 

大众点评券美团到店综券才返回

 

dealId

 

String

 

 

商品id

 

 

dealTitle

 

String

 

 

商品名称

 

dealPrice

 

Bigdecimal

 

 

商品售卖价格

单位:元

dealMarketPrice

 

Bigdecimal

 

 

商品市场价

单位:元

dealGroupId

 

String

 

 

团购ID

 

count

 

Integer

 

 

最大可验证张数

 

platformAmount

 

Bigdecimal

 

 

补贴金额(平台分摊)

单位:元

merchantAmount

 

Bigdecimal

 

 

补贴金额(商户分摊)

单位:元

tikTok

 

 

 

 

 

 

抖音券才返回

 

tiktokCertificateList

 

 

 

 

可核销券列表

 

certificateId

String

 

 

券id

 

num

Integer

 

 

可核销数量

仅次卡有该字段

amount

Object

 

 

金额

参考

sku

skuId

 

String

 

 

团购skuId

 

title

String

 

 

团购名称

 

accountId

 

String

 

 

商家团购账号id

 

marketPrice

 

String

 

 

团购市场价

单位:分

soldStartTime

String

 

 

团购售卖开始时间,时间戳,单位秒

 

thirdSkuId

String

 

 

商家系统(第三方)团购id

 

 

请求示例

{"type":"mtdz","couponNo":"5948286811","shopId":"147"}

响应示例

{

  "code": "0",

  "data": {

"validityBeginDate": "",

     "couponName": "0.1团10百货券",

     "couponType": "",

     "mtdz": {

       "dealId": "1316147453",

       "dealTitle": "0.1团10百货券",

       "dealPrice": 0.1,

       "dealGroupId": "1081740947"

     },

     "initAmount": 1,

     "validityEndDate": "",

"couponValue": "0.1",

"couponBuyPrice": "0.1"

  }

}


卜子超buzc 2025年12月3日 11:23 收藏文档