支付增值服务
接口列表
代金券
条件查询批次列表

条件查询批次列表

通过此接口可查询多个批次的信息,包括批次的配置信息以及批次概况数据。

接口说明

请求方式:
post
https://p.wecard.tencent.com/cloudpay/v1/favor/query-stock-list

请求参数

Request
Body 包体
offset必填
integer

页码从0开始,默认第0页。
示例值:0


limit必填
integer

分页大小,最大10。
示例值:8


create_start_time选填
string

起始创建时间,遵循rfc3339标准格式,格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE,yyyy-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss表示时分秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC8小时,即北京时间)。例如:2015-05-20T13:29:35+08:00表示,北京时间2015年5月20日13点29分35秒。
示例值:2015-05-20T13:29:35+08:00

最小长度:1     最大长度:64

create_end_time选填
string

终止创建时间,遵循rfc3339标准格式,格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE,yyyy-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss表示时分秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC8小时,即北京时间)。例如:2015-05-20T13:29:35+08:00表示,北京时间2015年5月20日13点29分35秒。
示例值:2015-05-20T13:29:35+08:00

最小长度:1     最大长度:64

status选填
string

批次状态,枚举值:
unactivated:未激活
audit:审核中
running:运行中
stoped:已停止
paused:暂停发放
示例值:paused

最小长度:1     最大长度:16

channel_merchant_id必填
string

请求示例

{
  "offset": 0,
  "limit": 8,
  "create_start_time": "2015-05-20T13:29:35+08:00",
  "create_end_time": "2015-05-20T13:29:35+08:00",
  "status": "paused",
  "channel_merchant_id": "CM465922975711959340"
}

返回参数

Response
Response必填
object

返回示例

{
  "Response": {
    "RequestId": "948948503842433001",
    "Result": {
      "total_count": 10,
      "data": [
        {
          "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_amount": 5000,
            "max_amount_by_day": 400,
            "fixed_normal_coupon": {
              "coupon_amount": 100,
              "transaction_minimum": 100
            },
            "max_coupons_per_user": 3,
            "trade_type": [
              "OTHER",
              "APPPAY"
            ]
          },
          "available_begin_time": "2015-05-20T13:29:35.120+08:00",
          "available_end_time": "2015-05-20T13:29:35.120+08:00",
          "distributed_coupons": 100,
          "no_cash": true,
          "singleitem ": true,
          "stock_type": "NORMAL"
        }
      ],
      "limit": 8,
      "offset": 1
    },
    "ErrCode": "SUCCESS",
    "ErrMessage": "成功"
  }
}

腾讯微卡收付通接口文档