微信小程序發(fā)紅包接口指南

紅包接口使用流程:登陸(搖搖啦平臺(tái))注冊(cè)賬號(hào)

發(fā)紅包兩種方式狂丝,一種是你直接做好一個(gè)鏈接給用戶劳澄,他點(diǎn)了就領(lǐng)紅包皂林,另一種是你在你的交互過程中嵌入靜默授權(quán),獲取到openid乱凿,然后隨時(shí)在后端可以發(fā)紅包顽素。


配置:


apikey:參數(shù)簽名密鑰,不超過32字節(jié)

對(duì)接ip:調(diào)用紅包創(chuàng)建接口的服務(wù)器IP徒蟆,可寫多個(gè)胁出,用逗號(hào)分隔


1.紅包創(chuàng)建接口(單紅包)

https://www.yaoyaola.net/exapi/hbticket


參數(shù)說明(GET):


uid:(必填)客戶編號(hào):系統(tǒng)分配?(每個(gè)賬號(hào)唯一)

type:(必填) 紅包類型,0使用紅包接口后专,1表示使用企業(yè)付款接口

如果使用企業(yè)付款划鸽,金額可以大于200元

企業(yè)付款的通知消息可自定義wishing,不顯示title和sendname

money:(必填)紅包金額,單位為分裸诽,不能低于30

orderid:(必填)自定義訂單號(hào)嫂用,不超過60字節(jié)

reqtick:(必填)請(qǐng)求時(shí)間戳,單位為秒丈冬,與北京標(biāo)準(zhǔn)時(shí)間誤差不能超過30秒

expire:紅包超時(shí)時(shí)間嘱函,單位為秒,不指定則默認(rèn)60秒

sign:(必填)參數(shù)驗(yàn)證簽名 md5(uid+type+orderid+money+reqtick+apikey)埂蕊,共32字節(jié)往弓,字母都為小寫

title:紅包活動(dòng)名稱(不能超過10個(gè)漢字或32個(gè)字符)

sendname:紅包發(fā)送方名稱(不能超過10個(gè)漢字或32個(gè)字符)

wishing:紅包祝福語(yǔ)

rurl:紅包領(lǐng)取結(jié)果跳轉(zhuǎn)url,用于給用戶顯示客戶的自定義頁(yè)面蓄氧,通過GET方式傳送三個(gè)參數(shù)(以下三行為平臺(tái)傳給rurl的參數(shù)),如果rurl為空函似,則跳轉(zhuǎn)至系統(tǒng)默認(rèn)結(jié)果頁(yè)面

ticket: 紅包回執(zhí)

retmoney: 紅包領(lǐng)取金額,單位為分喉童,0為領(lǐng)取失敗

retmsg: 返回信息

cburl:服務(wù)器通知url撇寞,參數(shù)形式同rurl,用戶紅包領(lǐng)取成功時(shí)回調(diào)此url,失敗則不回調(diào)堂氯,由客戶方在紅包超時(shí)后主動(dòng)查詢確認(rèn)結(jié)果蔑担。


PHP示例代碼:$apikey = "xxxxxxxxxxxxx";

$uid = 1;

$type = 0;

$money = 50;

$orderid = rand(1000,9999).rand(1000,9999).rand(1000,9999);

$reqtick = time();

$signstr = $uid.$type.$orderid.$money.$reqtick.$apikey;

$sign = md5($signstr);

$url = "https://www.yaoyaola.net/exapi/hbticket?uid=".$uid."&type=".$type."&orderid=".$orderid."&money=".$money."&

reqtick=".$reqtick."&expire=3600&sign=".$sign."&title=恭喜發(fā)財(cái)&sendname=千躍科技&wishing=心想事成";

$result = httpGet($url);

echo $result."\n";


請(qǐng)求示例:https://www.yaoyaola.net/exapi/hbticket?uid=1&type=0&orderid=657812195242&money=100&reqtick=1515133732&sign=7ad5e4da870203ed6c15bda5a60d06a4&title=恭喜發(fā)財(cái)&sendname=千躍科技&wishing=心想事成


返回結(jié)果:{"errcode":"0","errmsg":"success","ticket":"a06aba6515bbdb776f83fa74199bd3e9"}


2. 紅包領(lǐng)取接口(單紅包)

通過上面返回的ticket,拼裝出紅包領(lǐng)取鏈接:?https://www.yaoyaola.net/exapi/gethb/10000013?ticket=a06aba6515bbdb776f83fa74199bd3e9?,用戶點(diǎn)擊后咽白,則立刻領(lǐng)取紅包啤握,注意如果沒有指定超時(shí)時(shí)間,此鏈接有效時(shí)間默認(rèn)為60秒.

如果要在小程序中打開領(lǐng)取晶框,需要做如下操作:

? ? ? ? ? ? ? ? 1. 在小程序后臺(tái)設(shè)置服務(wù)域名為www.yaoyaola.net

? ? ? ? ? ? ? ? 2. 聯(lián)系平臺(tái)將域名校驗(yàn)文件上傳服務(wù)器

? ? ? ? ? ? ? ? 3. 將上面紅包鏈接協(xié)議頭http修改為https

3.授權(quán)跳轉(zhuǎn)接口


https://www.yaoyaola.net/exapi/check_user/


參數(shù)說明(GET):

url:獲取到openid后的跳轉(zhuǎn)url排抬,如果有帶參數(shù),可先對(duì)整個(gè)url做下urlencode編碼

flag:0表示靜默獲取openid三妈,1表示需要用戶授權(quán)獲取詳細(xì)信息

示例:https://www.yaoyaola.net/exapi/check_user/10000013?url=https://www.yaoyaola.net/exapi/test.html&flag=0

跳轉(zhuǎn)ulr示例:

test.html?ivtick=1547025023&u_openid=orsKq0c59kFgew2F2xfOWdRLQ-0M&encdata=3aae5867b37028491062d6f34e592772&userinfo=

跳轉(zhuǎn)URL攜帶參數(shù)說明(GET):

ivtick:當(dāng)前時(shí)間戳

u_openid:獲取到的用戶openid

encdata:簽名驗(yàn)證信息畜埋,md5(apikey+openid+ivtick)

userinfo:flag=1時(shí)返回的用戶詳細(xì)信息,base64編碼


4.紅包直發(fā)接口

https://www.yaoyaola.net/exapi/SendRedPackToOpenid


參數(shù)說明(GET):


uid:客戶編號(hào):1 (同上)

type:紅包類型畴蒲,0使用紅包接口悠鞍,1表示使用企業(yè)付款接口

如果使用企業(yè)付款,金額可以大于200元

企業(yè)付款的通知消息只能顯示sendname模燥,不能顯示活動(dòng)名稱和祝福語(yǔ)

money:紅包金額咖祭,單位為分,不能低于30

orderid:自定義訂單號(hào)

reqtick:請(qǐng)求時(shí)間戳

openid:用戶openid蔫骂,可通過上面check_user接口獲取

sign:參數(shù)驗(yàn)證簽名 md5(uid+type+orderid+money+reqtick+openid+apikey)

title:紅包活動(dòng)名稱(不能超過10個(gè)漢字或32個(gè)字符)

sendname:紅包發(fā)送方名稱(不能超過10個(gè)漢字或32個(gè)字符)

wishing:紅包祝福語(yǔ)


示例:https://www.yaoyaola.net/exapi/SendRedPackToOpenid?uid=1&type=0&orderid=793174198142&money=50&reqtick=1547025439&openid=orsKq0c59kFgew2F2xfOWdRLQ-0M&sign=a8f2333cd13153702db9b7a9bafc5b2f&title=恭喜發(fā)財(cái)&sendname=千躍科技&wishing=心想事成


成功返回:{"errcode":"0","errmsg":"","ticket":"f07bb87429ef4f33b9de...","retmoney":"50","retmsg":"發(fā)放成功"}


失敗返回:{"errcode":"100021","errmsg":"透?jìng)魑⑿藕笈_(tái)返回的錯(cuò)誤信息"}

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末么翰,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子辽旋,更是在濱河造成了極大的恐慌浩嫌,老刑警劉巖檐迟,帶你破解...
    沈念sama閱讀 219,039評(píng)論 6 508
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異码耐,居然都是意外死亡追迟,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,426評(píng)論 3 395
  • 文/潘曉璐 我一進(jìn)店門骚腥,熙熙樓的掌柜王于貴愁眉苦臉地迎上來敦间,“玉大人,你說我怎么就攤上這事束铭±椋” “怎么了?”我有些...
    開封第一講書人閱讀 165,417評(píng)論 0 356
  • 文/不壞的土叔 我叫張陵契沫,是天一觀的道長(zhǎng)带猴。 經(jīng)常有香客問我,道長(zhǎng)埠褪,這世上最難降的妖魔是什么浓利? 我笑而不...
    開封第一講書人閱讀 58,868評(píng)論 1 295
  • 正文 為了忘掉前任挤庇,我火速辦了婚禮钞速,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘嫡秕。我一直安慰自己渴语,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,892評(píng)論 6 392
  • 文/花漫 我一把揭開白布昆咽。 她就那樣靜靜地躺著驾凶,像睡著了一般。 火紅的嫁衣襯著肌膚如雪掷酗。 梳的紋絲不亂的頭發(fā)上调违,一...
    開封第一講書人閱讀 51,692評(píng)論 1 305
  • 那天,我揣著相機(jī)與錄音泻轰,去河邊找鬼技肩。 笑死,一個(gè)胖子當(dāng)著我的面吹牛浮声,可吹牛的內(nèi)容都是我干的虚婿。 我是一名探鬼主播,決...
    沈念sama閱讀 40,416評(píng)論 3 419
  • 文/蒼蘭香墨 我猛地睜開眼泳挥,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼然痊!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起屉符,我...
    開封第一講書人閱讀 39,326評(píng)論 0 276
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤剧浸,失蹤者是張志新(化名)和其女友劉穎锹引,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體唆香,經(jīng)...
    沈念sama閱讀 45,782評(píng)論 1 316
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡粤蝎,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,957評(píng)論 3 337
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了袋马。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片初澎。...
    茶點(diǎn)故事閱讀 40,102評(píng)論 1 350
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖虑凛,靈堂內(nèi)的尸體忽然破棺而出碑宴,到底是詐尸還是另有隱情,我是刑警寧澤桑谍,帶...
    沈念sama閱讀 35,790評(píng)論 5 346
  • 正文 年R本政府宣布延柠,位于F島的核電站,受9級(jí)特大地震影響锣披,放射性物質(zhì)發(fā)生泄漏贞间。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,442評(píng)論 3 331
  • 文/蒙蒙 一雹仿、第九天 我趴在偏房一處隱蔽的房頂上張望增热。 院中可真熱鬧,春花似錦胧辽、人聲如沸峻仇。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,996評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)摄咆。三九已至,卻和暖如春人断,著一層夾襖步出監(jiān)牢的瞬間吭从,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 33,113評(píng)論 1 272
  • 我被黑心中介騙來泰國(guó)打工恶迈, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留涩金,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 48,332評(píng)論 3 373
  • 正文 我出身青樓蝉绷,卻偏偏與公主長(zhǎng)得像鸭廷,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子熔吗,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,044評(píng)論 2 355

推薦閱讀更多精彩內(nèi)容