查询批次详情API

接口说明

接口url

https://api.mch.weixin.qq.com/v3/marketing/favor/stocks/{stockid}

请求方式

GET

请求参数

变量名

所处位置

数据类型

必填

描述

stock_id

path

string(20)

批次id

stock_creator_mchid

query

string(20)

批次创建方商户号

返回结果

状态码

含义

描述

数据类型

200

OK

处理成功

StockEntity

应答样例 200 Response


{
  "stock_id": "9836588",
  "stock_creator_mchid": "123456",
  "stock_name": "微信支付批次",
  "status": "paused",
  "create_time": "2015-05-20T13:29:35.120+08:00",
  "description": "微信支付营销",
  "stock_use_rule": {
    "max_coupons": 100,
    "max_conpons_by_day": 40,
    "max_amount": 5000,
    "max_amount_by_day": 400,
    "fixed_normal_coupon": null,
    "no_cash": true,
    "stock_type": "NORMAL",
    "distributed_coupons": 100,
    "max_coupons_per_user": 3,
    "singleitem": true,
    "coupon_type": "NORMAL",
    "order_tag": "123456"
  },
  "available_begin_time": "2015-05-20T13:29:35.120+08:00",
  "available_end_time": "2015-05-20T13:29:35.120+08:00"
}

StockEntity

变量名

数据类型

必填

示例

描述

stock_id

string

9836588

批次id

stock_creator_mchid

string

123456

微信为创建方商户分配的商户号

stock_name

string

微信支付批次

批次名称

status

string

paused

批次状态: unactivated-未激活;audit-审核中;running-运行中;stoped-已停止;paused-暂停发放

create_time

string

2015-05-20T13:29:35.120+08:00

批次创建时间

description

string

微信支付营销

批次描述信息

stock_use_rule

StockUseRule

none

普通发券批次特定信息

available_begin_time

string

2015-05-20T13:29:35.120+08:00

可用开始时间

available_end_time

string

2015-05-20T13:29:35.120+08:00

可用结束时间

distributed_coupons

int

100

已发券数量

no_cash

boolean

true

是否无资金流:true-是;false-否

start_time

string

2015-05-20T13:29:35.120+08:00

批次激活开启时间

stop_time

string

2015-05-20T13:29:35.120+08:00

批次永久停止时间

cut_to_message

CutToMessage

none

单品优惠特定信息

singleitem

boolean

true

是否单品优惠:true-是;false-否

stock_type

string

NORMAL

批次类型:NORMAL-代金券批次;DISCOUNT_CUT-立减与折扣;OTHER-其他

StockUseRule

变量名

数据类型

必填

示例

描述

max_coupons

int

100

最大发券数

max_amount

int

5000

总消耗金额,单位分

max_amount_by_day

int

400

单天最高消耗金额,单位分

fixed_normal_coupon

FixedNormalCoupon

none

固定面额发券批次特定信息

max_coupons_per_user

int(32)

3

单用户领券限制

coupon_type

string

NORMAL

券类型:NORMAL-满减券;CUT_TO-减至券

goods_tag

string

123456

订单优惠标记(暂时返回为空)

trade_type

enum

123456

默认不限制,值为: 小程序支付-MICROAPP、 APP支付-APPPAY、 免密支付-PPAY、付款码支付-CARD、人脸支付-FACE、(公众号、扫码等)-OTHER

combine_use

boolean

true

可与其他券叠加使用:ture-是;false-否

CutToMessage

single_price_max

int(64)

100

单品最高优惠价格,单位分

cut_to_price

int(64)

100

减至后单价,单位分

FixedNormalCoupon

coupon_amount

int

100

面额,单位分

transaction_minimum

int

100

使用券金额门槛,单位分

错误码