3.2.28第三方核券准备接口


allinpay.shopoint.thirdCouponService.prepare

version: 1.0

业务请求参数

字段名

参数类型

必填

最大长度

说明

取值

type

 

 

String

 

类型

meituan

tiktok

dianping  mtdz

couponNo

 

 

String

 

券号

 

shopId

 

 

Integer

 

店铺号

 

 

业务响应参数

字段名

参数类型

必填

最大长度

说明

取值

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

 

 

可核销数量

仅次卡有该字段

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年5月14日 16:54 收藏文档