★ 背景
- 近期進(jìn)行小程序的開發(fā)绩脆,畢竟是商城項目的開發(fā)刘莹,最后牽扯到的微信支付是必要的
- 個人開發(fā)過程中也是遇到各種問題,在此目代,我根據(jù)自己的實際操作屈梁,進(jìn)行了代碼的詳細(xì)配置,以方便小程序新手的快速操作
- 使用語言:PHP # PHP世界上最好的語言 HaHahahaaha
- 使用框架:ThinkPHP 3.2 # 版本有點低而已榛了,沒啥大礙
- 測試工具:微信開發(fā)者工具 # 其實還挺好用
- 整理時間:2018-07-07 # 有問題在讶,就會一直更新
tip: 【代碼都是可轉(zhuǎn)化的,即便是ThinkPHP5.0+ 還是Laravel框架忽冻,相對熟悉PHP代碼語法的真朗,進(jìn)行轉(zhuǎn)化也只是分分鐘的事哦!】
一僧诚、開發(fā)前的準(zhǔn)備
①. 開發(fā)步驟
- 如果開發(fā)者已做過
JSAPI
或JSSDK
調(diào)起微信支付遮婶,接入小程序支付非常相似,以下是三種接入方式的對比:
- 如此看來湖笨,小程序要想集成支付功能旗扑,倒是簡單了
- 對公眾號微信支付感興趣的可以參考之前整理的一篇文章 —— 微信公眾平臺開發(fā)[4] —— ThinkPHP 框架下微信支付
②. 閱讀業(yè)務(wù)流程圖
-
本人強(qiáng)烈推薦閱讀這個圖示,流程明確了慈省,代碼邏輯自然也就理順了臀防!
③. 小程序支付業(yè)務(wù)
- 此處,小程序官方已做了詳細(xì)說明 —— 業(yè)務(wù)說明
# 很多人這一步還沒有完成边败,就咔咔咔的測試支付功能袱衷,顯然是太急于求成了,比如:我笑窜!
> 注意:
> 1. 要開通微信支付功能(一般有兩三天的審核時間)
> 2. 本人開通后致燥,選擇的是 “綁定一個已有的微信支付商戶號”,也就幾分鐘的事
- 此處請閱讀官方文末的注意事項【重要】:
1 appid 必須為最后拉起收銀臺的小程序appid排截;
# 這句話感覺不說還好嫌蚤,一說更容易引起多余的考慮(忽視)
2 mch_id 為和 appid 成對綁定的支付商戶號辐益,收款資金會進(jìn)入該商戶號;
# 此處我直接使用了所綁定的商戶號中的 mch_id
3 trade_type 請?zhí)顚?JSAPI"脱吱;
# 可暫時忽略智政,因為我在代碼中已進(jìn)行了配置
4 openid 為 appid 對應(yīng)的用戶標(biāo)識,即使用 "wx.login" 接口獲得的 openid
# 可參考我的 payment/index.js 代碼
# 另一種情況箱蝠,如果項目數(shù)據(jù)庫中已保存了該用戶的openid字段续捂,可自行獲取
二、小程序端代碼配置指導(dǎo)
- 這里進(jìn)行配置的代碼抡锈,都在附錄源碼包的
wxMini-PayDemo\wxChat
目錄下
為了項目代碼的
通用性/易管理性
疾忍,我自行提取出了兩個主要的公共文件config.js
和util.js
;
①. utils下 config.js
文件的使用
-
config.js
文件中,主要就是配置一些公共訪問路徑之類的數(shù)據(jù)床三,方便后期代碼上線后的鏈接更改 - 所以一罩,對于其中的
restUrl
和imgServer
修改為自己的服務(wù)器地址即可
> 注意一點:
> 我的 restUrl 是對應(yīng)于我的小程序 Api接口路徑的,舉個例子:
> 我的支付回調(diào)路徑為 "https://www.mySercver.com/WxApi/Pay/notify"
②. utils下 util.js
文件的使用
- 這個是和
config.js
文件在同一目錄下的公共文件 - 其實就是整合了三個主要的方法撇簿,需要注意的是:如果你有所補(bǔ)充聂渊,記得在文件的最后進(jìn)行輸出就好
module.exports = {
http_get: http_get,
http_post: http_post,
showToast: showToast,
}
③. payment/index.js
文件的使用
- 此文件作為 小程序微信支付前端的核心文件
- 在保證你的各個文件目錄對應(yīng)配置正確的情況下,只需在進(jìn)行支付喚醒時四瘫,調(diào)用其中的
btnClickToPay()
方法即可:
- 當(dāng)然汉嗽,我只是隨便定的一個方法,實際使用的時候找蜜,其實就是以類似的形式饼暑,去調(diào)用后面的
wxPay()
方法唄!
三洗做、服務(wù)端代碼文件的使用指導(dǎo)
- 這里進(jìn)行配置的代碼弓叛,都在源碼包的
wxMini-PayDemo\Server-PHP
目錄下
聲明:
***因為本人所提供的代碼是基于ThinkPHP3.2
框架編寫整理的,所以對于使用過ThinkPHP
或Laravel
框架的PHPer
來說诚纸,簡單明了撰筷,可根據(jù)自己的框架進(jìn)行調(diào)整適配,所以畦徘,此處講的可能不會太過瑣碎 ***
①. 公共配置文件的數(shù)據(jù)補(bǔ)充
- 此為源代碼中的
"wxMini-PayDemo\Server-PHP\Conf\config.php"
毕籽,此文件代碼比較少,我直接進(jìn)行展示:
return array(
//'配置項'=>'配置值'
'wxPay' => [
'appid' => 'wx8787xxxxxxxxxxxxx',//TODO 此處使用的是小程序的 APPID
'app_secret' => '0a7xxxxxxxxxxxxxxxxxxxxxxxxxxxxx622', //小程序的應(yīng)用密鑰
'pay_mchid' => '13xxxxxx02', // 微信支付MCHID 商戶收款賬號
'pay_apikey' => '1qaxxxxxxxxxxxxxxxxxxxxxhgf5', // 微信支付KEY
'notify_url' => 'https://www.mySercver.com/WxApi/Pay/notify', // 微信支付成功后進(jìn)行回調(diào)的鏈接
'login_url' => "https://api.weixin.qq.com/sns/jscode2session?" .
"appid=%s&secret=%s&js_code=%s&grant_type=authorization_code", // 微信使用code換取用戶openid及session_key的url地址
],
);
- 對于上述配置信息的來源井辆,應(yīng)該沒啥疑問吧关筒?
注意一點:
"notify_url" 作為支付回調(diào)的鏈接地址,要求配置成自己的服務(wù)器路徑
;#同時注意協(xié)議的要求 “https”
小程序官方要求:
;# 需要進(jìn)行服務(wù)器域名的配置
;# 操作位置為 “小程序(微信公眾平臺)/設(shè)置/開發(fā)設(shè)置”中的“服務(wù)器域名->request合法域名”
②. 公共方法 function.php
的補(bǔ)充
- 對于本人的邏輯處理中杯缺,其實只有一個方法
curl_get()
, 并且只在PayController.class.php
的getOpenID()
方法中進(jìn)行了一次調(diào)用平委,也可以自行提取使用的
③. 核心處理文件 PayController.class.php
- 此文件代碼已做了詳細(xì)處理,在你正確放置后夺谁,需要注意的幾點如下:
(1). 注意命名空間 "namespace" 與自己業(yè)務(wù)代碼的對應(yīng)
(2). 在 "prepay()" 方法中廉赔,因為不同的業(yè)務(wù)都會有屬于自己的判斷處理邏輯,
所以匾鸥,在使用時完全可以替換掉所調(diào)用的 "prepayOrderDeal()" 方法 ;# 相信沒多大歧義吧蜡塌!
#【在此處,我建議進(jìn)行一下微信支付金額的校對勿负,
# 比如馏艾,通過訂單號到你的項目數(shù)據(jù)庫中,查詢出需要支付的金額再與此比較奴愉,
# 只有符合你的要求才可以進(jìn)行微信支付的下單操作】
(3). 再有就是琅摩,在 "notify()" 這個回調(diào)方法中,一定會涉及到自己業(yè)務(wù)的更新處理邏輯
所以被調(diào)用的 "payNotifyOrderDeal()" 方法中就可以改成你自己的業(yè)務(wù)邏輯了
;#此處是可以自行補(bǔ)充的
注意锭硼,此處傳入的 "$result" 參數(shù)中,我主要使用的就是其中的 "out_trade_no" 和 "total_fee"
# 包含著微信支付的眾多信息房资,可自行提取
前者用于匹配我對該已支付訂單的后續(xù)更新操作
#【提示:我在使用時需要使用 "M" 進(jìn)行字符串的截取才是我自己業(yè)務(wù)的實際訂單編號哦!】;
后者是實際微信消費(fèi)的金額檀头,可用于數(shù)據(jù)表的記錄轰异,以方便對賬人員的校對工作
四、使用及測試效果
①. 測試效果
-
在我的小程序項目中暑始,喚醒的效果(開發(fā)工具中)如下:
-
如果是在自己的手機(jī)端進(jìn)行測試搭独,在保證你的域名配置正確的情況下,喚醒的樣式就是常見的樣子:
②. 補(bǔ)充說明
- 相信在實際配置使用的過程中一定會出現(xiàn)各種問題廊镜,我也是一點點的梳理排錯過來的
- 前面的多是些配置問題的規(guī)范牙肝,如果到了最后的喚醒階段,出現(xiàn)的問題要注意查看開發(fā)工具的控制臺嗤朴,
- 其中會有比較詳細(xì)的報錯信息配椭,然后再進(jìn)行排查解決
- 有何問題,歡迎指摘播赁,祝你配置順利咯颂郎!
☆ 附錄:
①. >>> 源碼下載參考
②. 總結(jié)
- 通過對以上操作的梳理,可以提取出主要的幾個步驟:
- . 小程序要開通你的微信支付功能 # 需要審核時間的
- . 審核通過后容为,緊接著進(jìn)行"開通"操作 #可有兩種開通方式進(jìn)行選擇的
- . 前后端重要信息配置完畢
- . 補(bǔ)充自己的特有邏輯處理操作 #pay/prepayOrderDeal()和 pay/payNotifyOrderDeal()
- . 支付回調(diào)成功后乓序,進(jìn)行后續(xù)的訂單(項目服務(wù)器)查詢操作