---
url: "https://pay.weixin.qq.com/doc/v2/merchant/4011937428.md"
title: "领取红包接口"
doc_id: 4011937428
---

>更新时间：2025.06.20

## 使用场景

用户在微信中访问小程序的网页，小程序（网页方）在活动时可以拉起发送原生企业红包入口

## 接口调用请求说明

| 接口名称 | sendBizRedPacket |
| --- | --- |
| 功能 | 在微信内置浏览器中被访问的网页，可使用该JS代码商户拉起发送原生企业红包入口 |

## 调用方式:

```
wx. sendBizRedPacket ({
    "timeStamp": "", // 支付签名时间戳，
    "nonceStr": "", // 支付签名随机串，不长于 32 位
    "package": "", //扩展字段，由商户传入
    "signType": "", // 签名方式，
    "paySign": "", // 支付签名
    "success":function(res){},
    "fail":function(res){},
    "complete":function(res){}
})
```

## 请求参数

| 字段名 | 字段 | 必填 | 示例值 | 类型 | 说明 |
| --- | --- | --- | --- | --- | --- |
| 时间戳 | timeStamp | 是 | 1514363815 | String(32) | 调用方生成的时间戳,需为字符串 |
| 随机字符串 | nonceStr | 是 | Ww213sdad | String(32) | 调用方生成的随机字符串 |
| 红包详情的扩展 | package | 是 | sendid%3D242e8abd163d300019b2cae74ba8e8c06e3f0e51ab84d16b3c80decd22a5b672%26ver%3D8%26sign%3D4110d649a5aef52dd6b95654ddf91ca7d5411ac159ace4e1a766b7d3967a1c3dfe1d256811445a4abda2d9cfa4a9b377a829258bd00d90313c6c346f2349fe5d%26mchid%3D11475856%26appid%3Dwxd27ebc41b85ce36d | String(256) | 商户将红包信息组成该串，具体方案参见package的说明，package需要进行urlencode再传给页面 |
| 签名方式 | signType | 是 | 字符串类型，参数取值"MD5" | String(32) | 按照文档中所示填入，目前仅支持MD5 |
| 签名 | paySign | 是 | 70f47031c8e8d4bb78e741f8d0ee45beef65cfcd | String(256) | 生成签名方式查看3.2.2节 |

## 返回参数

| 字段名 | 字段 | 必填 | 示例值 | 类型 | 说明 |
| --- | --- | --- | --- | --- | --- |
| 返回状态码 | retcode | 是 | 0 | int | 0 表示调用成功。 <br>非0 表示接口失败 |
| 返回信息 | retmsg | 否 | 签名失败 | String(128) | 返回信息，如非空，为错误原因。<br>签名失败<br>参数格式校验错误<br>已经绑定过红包<br>已经过期 |

## 回调函数说明:

1.success：接口调用成功时执行的回调函数。

2.fail：接口调用失败时执行的回调函数。

3.complete：接口调用完成时执行的回调函数，无论成功或失败都会执行。

以上几个函数都带有一个参数，类型为对象，其中除了每个接口本身返回的数据之外，还有一个通用属性errMsg，其值格式如下：

调用成功时："xxx:ok" ，其中xxx为调用的接口名

用户取消时："xxx:cancel"，其中xxx为调用的接口名

调用失败时：其值为具体错误信息

## paySign生成方法

字段说明：paySign 字段是对本次发起JSAPI 的行为进行鉴权，只有通过了paySign 鉴权，才能继续对package 鉴权并调起红包的收和拆。

生成规则：参与paySign 签名的字段包括：appId、timeStamp、nonceStr、package 。这里signType 并不参与签名。

1. 对所有待签名参数按照字段名的 ASCII码从小到大排序（字典序）后，使用 URL 键 值对的格式（即key1=value1&key2=value2…）拼接成字符串string1。这里需要注意的是所有参数名均为驼峰形式

2. 在string1最后拼接上key=商户支付密钥得到stringSignTemp字符串

3. 对 stringSignTemp 作MD5签名算法，字段名和字段值都采用原始值（package需要进行urlencode再进行加密），最后得到的字符串不用转成大写， 具体签名算法为 paySign =MD5(stringSignTemp)