領(lǐng)取紅包接口
使用場景
用戶在微信中訪問小程序的網(wǎng)頁，小程序（網(wǎng)頁方）在活動(dòng)時(shí)可以拉起發(fā)送原生企業(yè)紅包入口
接口調(diào)用請(qǐng)求說明
| 接口名稱 | sendBizRedPacket |
|---|---|
| 功能 | 在微信內(nèi)置瀏覽器中被訪問的網(wǎng)頁，可使用該JS代碼商戶拉起發(fā)送原生企業(yè)紅包入口 |
調(diào)用方式:
- wx. sendBizRedPacket ({
- ??? "timeStamp": "", // 支付簽名時(shí)間戳，
- ??? "nonceStr": "", // 支付簽名隨機(jī)串，不長于 32 位
- ??? "package": "", //擴(kuò)展字段，由商戶傳入
- ??? "signType": "", // 簽名方式，
- ??? "paySign": "", // 支付簽名
- ??? "success":function(res){},
- ??? "fail":function(res){},
- ??? "complete":function(res){}
- })
請(qǐng)求參數(shù)
| 字段名 | 字段 | 必填 | 示例值 | 類型 | 說明 |
|---|---|---|---|---|---|
時(shí)間戳 |
timeStamp |
是 |
1514363815 |
String(32) |
調(diào)用方生成的時(shí)間戳,需為字符串 |
隨機(jī)字符串 |
nonceStr |
是 |
Ww213sdad |
String(32) |
調(diào)用方生成的隨機(jī)字符串 |
紅包詳情的擴(kuò)展 |
package |
是 |
sendid%3D242e8abd163d300019b2cae74ba8e8c06e3f0e51ab84d16b3c80decd22a5b672%26ver%3D8%26sign%3D4110d649a5aef52dd6b95654ddf91ca7d5411ac159ace4e1a766b7d3967a1c3dfe1d256811445a4abda2d9cfa4a9b377a829258bd00d90313c6c346f2349fe5d%26mchid%3D11475856%26appid%3Dwxd27ebc41b85ce36d |
String(256) |
商戶將紅包信息組成該串，具體方案參見package的說明，package需要進(jìn)行urlencode再傳給頁面 |
簽名方式 |
signType |
是 |
字符串類型，參 |
String(32) |
按照文檔中所示填入，目前僅支持MD5 |
簽名 |
paySign |
是 |
70f47031c8e8d4bb78e741f8d0ee45beef65cfcd |
String(256) |
生成簽名方式查看3.2.2節(jié) |
返回參數(shù)
| 字段名 | 字段 | 必填 | 示例值 | 類型 | 說明 |
|---|---|---|---|---|---|
返回狀態(tài)碼 |
retcode |
是 |
0 |
int |
0 表示調(diào)用成功。? |
返回信息 |
retmsg |
否 |
簽名失敗 |
String(128) |
返回信息，如非空，為錯(cuò)誤原因。 |
回調(diào)函數(shù)說明:
1.success：接口調(diào)用成功時(shí)執(zhí)行的回調(diào)函數(shù)。
2.fail：接口調(diào)用失敗時(shí)執(zhí)行的回調(diào)函數(shù)。
3.complete：接口調(diào)用完成時(shí)執(zhí)行的回調(diào)函數(shù)，無論成功或失敗都會(huì)執(zhí)行。
以上幾個(gè)函數(shù)都帶有一個(gè)參數(shù)，類型為對(duì)象，其中除了每個(gè)接口本身返回的數(shù)據(jù)之外，還有一個(gè)通用屬性errMsg，其值格式如下：
調(diào)用成功時(shí)："xxx:ok" ，其中xxx為調(diào)用的接口名
用戶取消時(shí)："xxx:cancel"，其中xxx為調(diào)用的接口名
調(diào)用失敗時(shí)：其值為具體錯(cuò)誤信息