发放代金券批次

商户平台/API完成制券后，可使用发放代金券接口发券。通过调用此接口可发放指定批次给指定用户，发券场景可以是小程序、H5、APP等。

接口说明

请求方式：

post

https://p.wecard.tencent.com/cloudpay/v1/favor/present-stock

请求参数

Request

Body 包体

stock_id必填

string

微信为每个批次分配的唯一id。
校验规则：必须为代金券（全场券或单品券）批次号，不支持立减与折扣。
示例值：9856000

最小长度：1 最大长度：20

openid必填

string

openid信息，用户在appid下的唯一标识。
校验规则：该openid需要与接口传入中的appid有对应关系。
示例值：2323dfsdf342342

最小长度：1 最大长度：128

out_request_no必填

string

商户此次发放凭据号（格式：商户id+日期+流水号），可包含英文字母，数字，

最小长度：1 最大长度：128

wx_appid必填

string

微信为发券方商户分配的公众账号ID，接口传入的所有appid应该为公众号的appid或者小程序的appid（在mp.weixin.qq.com申请的）或APP的appid（在open.weixin.qq.com申请的）。
校验规则：
1、该appid需要与接口传入中的openid有对应关系；
2、该appid需要与调用接口的商户号（即请求头中的商户号）有绑定关系，若未绑定，可参考该指引完成绑定（商家商户号与AppID账号关联管理）
示例值：wx233544546545989

最小长度：1 最大长度：128

coupon_value选填

uint64

指定面额发券场景，券面额，其他场景不需要填，单位：分。（该字段暂未开放）
校验规则：仅在发券时指定面额及门槛的场景才生效，常规发券场景请勿传入该信息。
示例值：100

coupon_minimum选填

uint64

指定面额发券批次门槛，其他场景不需要，单位：分。（该字段暂未开放）
校验规则：仅在发券时指定面额及门槛的场景才生效，常规发券场景请勿传入该信息。
示例值：100

channel_merchant_id必填

string

请求示例

{
  "stock_id": "9856000",
  "out_request_no": "89560002019101000121",
  "wx_appid": "wx233544546545989",
  "openid": "2323dfsdf342342",
  "channel_merchant_id": "CM465922975711959340"
}

返回参数

Response

200 OK

Response必填

object

返回示例

{
  "Response": {
    "RequestId": "948948503842433001",
    "Result": {
      "coupon_id": "9867041"
    },
    "ErrCode": "SUCCESS",
    "ErrMessage": "成功"
  }
}

发放代金券批次

接口说明

请求参数

请求示例

返回参数

子属性

返回示例