创建代金券批次API

接口说明

适用对象: 直连商户 服务商 渠道商
请求 URL: https://api.mch.weixin.qq.com/v3/marketing/favor/coupon-stocks
请求方式: POST
接口规则: https://wechatpay-api.gitbook.io/wechatpay-api-v3

path 指该参数需在请求 URL 传参
query 指该参数需在请求 JSON 传参

请求参数

变量 |类型 |必填 |参数名/描述/示例值

批次名称 stock_name string(20) 是 query 批次名称 |||微信支付代金券批次 批次备注 comment string(60) 否 query 仅配置商户可见, 用于自定义信息。 |||零售批次 归属商户号 belong_merchant string(20) 是 query 批次归属商户号 |||98568865 开始时间 available_begin_time string(32) 是 query 批次开始时间, 遵循 rfc3339 标准格式, 格式为 YYYY-MM-DDTHH:mm:ss:sss+TIMEZONE, YYYY-MM-DD 表示年月日, T 出现在字符串中, 表示 time 元素的开头, HH:mm:ss:sss 表示时分秒毫秒, TIMEZONE 表示时区(+08:00 表示东八区时间, 领先 UTC 8 小时, 即北京时间）。例如: 2015-05-20T13:29:35.120+08:00 表示, 北京时间 2015 年 5 月 20 日 13 点 29 分 35 秒。 |||2015-05-20T13:29:35.120+08:00 结束时间 available_end_time string(32) 是 query 批次结束时间, 遵循 rfc3339 标准格式, 格式为 YYYY-MM-DDTHH:mm:ss:sss+TIMEZONE, YYYY-MM-DD 表示年月日, T 出现在字符串中, 表示 time 元素的开头, HH:mm:ss:sss 表示时分秒毫秒, TIMEZONE 表示时区(+08:00 表示东八区时间, 领先 UTC 8 小时, 即北京时间）。例如: 2015-05-20T13:29:35.120+08:00 表示, 北京时间 2015 年 5 月 20 日 13 点 29 分 35 秒。 |||2015-05-20T13:29:35.120+08:00 +发放规则 stock_use_rule object 是 query 批次使用规则 +样式设置 pattern_info object 否 query 代金券详情页 +核销规则 coupon_use_rule object 是 query 核销规则 是否无资金流 no_cash bool 是 query 是否无资金流。枚举值:
true: 是
false: 否 |||false 批次类型 stock_type string(16) 是 query 批次类型, 枚举值:
NORMAL: 固定面额满减券批次 |||NORMAL 商户单据号 out_request_no string(128) 是 query 商户创建批次凭据号(格式: 商户 id+日期+流水号）, 可包含英文字母, 数字, |, *, *, -等内容, 不允许出现其他不合法符号, 商户侧需保持唯一性。 扩展属性 ext_info string(128) 否 query 扩展属性字段, 按 json 格式, 暂时无需填写。 |||{‘exinfo1’:‘1234’,‘exinfo2’:‘3456’} 卡券背景颜色图

请求示例

{
  "stock_name": "微信支付代金券批次",
  "comment": "零售批次",
  "belong_merchant": "98568865",
  "available_begin_time": "2015-05-20T13:29:35.120+08:00",
  "available_end_time": "2015-05-20T13:29:35.120+08:00",
  "stock_use_rule": {
    "max_coupons": 100,
    "max_amount": 5000,
    "max_amount_by_day": 400,
    "max_coupons_per_user": 3,
    "natural_person_limit": false,
    "prevent_api_abuse": false
  },
  "pattern_info": {
    "description": "微信支付营销代金券",
    "merchant_logo": "CDN 地址",
    "merchant_name": "微信支付",
    "background_color": "色号",
    "coupon_image": "图片 cdn 地址"
  },
  "coupon_use_rule": {
    "coupon_available_time": {
      "fix_available_time": {
        "available_week_day": [1],
        "begin_time": 0,
        "end_time": 3600
      },
      "second_day_available": false,
      "available_time_after_receive": 1440
    },
    "fixed_normal_coupon": {
      "coupon_amount": 50,
      "transaction_minimum": 100
    },
    "disscount_coupon": {
      "discount_amount_max": 100,
      "discount_percent": 88,
      "transaction_minimum": 100
    },
    "exchange_coupon": {
      "single_price_max": 100,
      "exchange_price": 100
    },
    "goods_tag": ["123321", "123322"],
    "trade_type": "OTHER",
    "combine_use": false,
    "available_items": ["123321", "123322"],
    "unavailable_items": ["789987", "789988"],
    "available_merchants": ["9856000", "9856001"]
  },
  "no_cash": false,
  "stock_type": "NORMAL",
  "out_request_no": ""
}

返回参数

变量 |类型 |必填 |参数名/描述/示例值

批次号 stock_id string(20) 是 微信为每个代金券批次分配的唯一 ID。 |||98065001 创建时间 create_time string(32) 是 创建时间, 遵循 rfc3339 标准格式, 格式为 YYYY-MM-DDTHH:mm:ss:sss+TIMEZONE, YYYY-MM-DD 表示年月日, T 出现在字符串中, 表示 time 元素的开头, HH:mm:ss:sss 表示时分秒毫秒, TIMEZONE 表示时区(+08:00 表示东八区时间, 领先 UTC 8 小时, 即北京时间）。例如: 2015-05-20T13:29:35.120+08:00 表示, 北京时间 2015 年 5 月 20 日 13 点 29 分 35 秒。 |||2015-05-20T13:29:35.120+08:00

返回示例

{
  "stock_id": "98065001",
  "create_time": "2015-05-20T13:29:35.120+08:00"
}

错误码_{公共错误码}

Feedback

Was this page helpful?

很高兴听到！ 请告诉我们，我们如何才能改善.

很遗憾听到这个消息。 请告诉我们，我们如何才能改善.