這一篇是《iOS開(kāi)發(fā)之支付》這一部分的繼支付寶支付集成,銀聯(lián)支付集成第三篇,微信支付。在集成的時(shí)候建議都要去下載最新版的SDK,因?yàn)槲抑赖那安痪弥Ц秾殻y聯(lián)都更新了一次,微信的不太清楚更新了沒(méi)。
在被支付寶、銀聯(lián)坑過(guò)之后,發(fā)現(xiàn)其實(shí)微信支付的集成并沒(méi)有想象中的那么困難,像支付寶那樣簡(jiǎn)單地調(diào)用個(gè)方法就行,重要的難的部分都是后臺(tái)來(lái)做的。微信支付也是需要簽名的,也跟支付寶一樣,可以在客戶端簽名,也可以在后臺(tái)簽名(當(dāng)然,為了安全還是推薦在服務(wù)器上做簽名,邏輯也比較好理解)。
集成前首先要看看文檔,
開(kāi)發(fā)文檔在這里還有
APP端開(kāi)發(fā)步驟也是需要好好看看的。
ps:在微信開(kāi)發(fā)者平臺(tái)注冊(cè)APP這樣的事一般的是經(jīng)理給你做好的,這個(gè)可以忽略,如果需要做的話,可以參考這篇文章。
交互流程
這個(gè)流程和支付寶的流程都差不多,理解了其實(shí)是一樣的。
首先需要理清楚流程:
- 用戶使用APP客戶端,選擇商品下單。
- 商戶客戶端(就是你做的APP)將用戶的商品數(shù)據(jù)傳給商戶服務(wù)器,請(qǐng)求生成支付訂單。
- 商戶后臺(tái)調(diào)用統(tǒng)一下單API向微信的服務(wù)器發(fā)送請(qǐng)求,微信服務(wù)器生成預(yù)付單,并生成一個(gè)prepay_id返回給商戶后臺(tái)。
- 商戶后臺(tái)將這個(gè)prepay_id返回給商戶客戶端。
- 用戶點(diǎn)擊確認(rèn)支付,這時(shí)候商戶客戶端調(diào)用SDK打開(kāi)微信客戶端,進(jìn)行微信支付。
- 微信客戶端向微信服務(wù)器發(fā)起支付請(qǐng)求并返回支付結(jié)果(他們之間交互用的就是prepay_id這個(gè)參數(shù),微信的服務(wù)器要驗(yàn)證微信客戶端傳過(guò)去的參數(shù)是否跟第三步中生成的那個(gè)id一致)。
- 用戶輸入支付密碼后,微信客戶端提交支付授權(quán),跟微信服務(wù)器交互,完成支付
- 微信服務(wù)器給微信客戶端發(fā)送支付結(jié)果提示,并異步給商戶服務(wù)器發(fā)送支付結(jié)果通知。
- 商戶客戶端通過(guò)支付結(jié)果回調(diào)接口查詢支付結(jié)果,并向后臺(tái)檢查支付結(jié)果是否正確,后臺(tái)返回支付結(jié)果。
- 商戶客戶端顯示支付結(jié)果,完成訂單,發(fā)貨。
雖然看起來(lái)有點(diǎn)多,但是理解起來(lái)并不復(fù)雜,跟我們平時(shí)手機(jī)上買東西是一樣的。我們客戶端需要做的就是
- 調(diào)起微信客戶端發(fā)起支付
- 顯示支付結(jié)果
集成過(guò)程
首先是要下載SDK,
建議頭文件和示例都下載出來(lái)看看。(吐槽下,官方的示例難看死了,看的眼暈!注釋都沒(méi)幾個(gè)。。。鄙視之)
導(dǎo)入微信支付SDK庫(kù)
導(dǎo)入上面那個(gè)iOS頭文件和庫(kù)下載下載出來(lái)的SDK包的就行啦,我這里的是SDK1.6.2. 然后需要鏈接上依賴庫(kù),在Target —> BuildPhases —> Link Binary With Libraries— 點(diǎn)擊+號(hào) -> 搜索你需要的系統(tǒng)庫(kù)。
- SystemConfiguration.framework
- libz.tbd
- libsqlite3.0.tbd
- CoreTelephony.framework
- QuartzCore.framework
設(shè)置URL Scheme
在注冊(cè)微信平臺(tái)APP的時(shí)候,會(huì)給一個(gè)唯一識(shí)別標(biāo)識(shí)符(APPID),在APP端開(kāi)發(fā)步驟里面說(shuō)得很清楚了,需要填在URL Schemes這個(gè)地方,
在Appdelegate中注冊(cè)APPID
如下:
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// Override point for customization after application launch.
/**
* 向微信終端注冊(cè)ID,這里的APPID一般建議寫成宏,容易維護(hù)。@“測(cè)試demo”不需用管。這里的id是假的,需要改這里還有target里面的URL Type
*/
[WXApi registerApp:@"wxd930ea5d5a258f4f" withDescription:@"測(cè)試demo"];
return YES;
}
處理微信通過(guò)URL啟動(dòng)時(shí)傳遞的數(shù)據(jù)
//前面的兩個(gè)方法被iOS9棄用了,如果是Xcode7.2網(wǎng)上的話會(huì)出現(xiàn)無(wú)法進(jìn)入進(jìn)入微信的onResp回調(diào)方法,就是這個(gè)原因。本來(lái)我是不想寫著兩個(gè)舊方法的,但是一看官方的demo上寫的這兩個(gè),我就也寫了。。。。
//9.0前的方法,為了適配低版本 保留
- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url{
return [WXApi handleOpenURL:url delegate:self];
}
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation{
return [WXApi handleOpenURL:url delegate:self];
}
//9.0后的方法
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<NSString *,id> *)options{
//這里判斷是否發(fā)起的請(qǐng)求為微信支付,如果是的話,用WXApi的方法調(diào)起微信客戶端的支付頁(yè)面(://pay 之前的那串字符串就是你的APPID,)
return [WXApi handleOpenURL:url delegate:self];
}
//微信SDK自帶的方法,處理從微信客戶端完成操作后返回程序之后的回調(diào)方法,顯示支付結(jié)果的
-(void) onResp:(BaseResp*)resp
{
//啟動(dòng)微信支付的response
NSString *payResoult = [NSString stringWithFormat:@errcode:%d, resp.errCode];
if([resp isKindOfClass:[PayResp class]]){
//支付返回結(jié)果,實(shí)際支付結(jié)果需要去微信服務(wù)器端查詢
switch (resp.errCode) {
case 0:
payResoult = @支付結(jié)果:成功!;
break;
case -1:
payResoult = @支付結(jié)果:失敗!;
break;
case -2:
payResoult = @用戶已經(jīng)退出支付!;
break;
default:
payResoult = [NSString stringWithFormat:@支付結(jié)果:失敗!retcode = %d, retstr = %@, resp.errCode,resp.errStr];
break;
}
}
}
最重要的來(lái)了!!
調(diào)用微信支付前,需要下單、簽名等操作,以便獲取微信支付所必要的參數(shù)。為了提高安全性,下單、簽名操作一般是在后臺(tái)完成,在前臺(tái)做的話被捕獲改信息就不開(kāi)心了。。。。。
需要的參數(shù)包括:appid、partid(商戶號(hào))、prepayid(預(yù)支付訂單ID)、noncestr(參與簽名的隨機(jī)字符串)、timestamp(參與簽名的時(shí)間戳)、sign(簽名字符串)這六個(gè)。
在點(diǎn)擊支付的控制器中使用核心代碼來(lái)調(diào)起微信客戶端支付,這些個(gè)參數(shù)都是后臺(tái)傳給你的。 加上了注釋,應(yīng)該很好理解的。
#pragma mark 微信支付方法
- (void)WXPay{
//需要?jiǎng)?chuàng)建這個(gè)支付對(duì)象
PayReq *req = [[PayReq alloc] init];
//由用戶微信號(hào)和AppID組成的唯一標(biāo)識(shí),用于校驗(yàn)微信用戶
req.openID = @"";
// 商家id,在注冊(cè)的時(shí)候給的
req.partnerId = @"";
// 預(yù)支付訂單這個(gè)是后臺(tái)跟微信服務(wù)器交互后,微信服務(wù)器傳給你們服務(wù)器的,你們服務(wù)器再傳給你
req.prepayId = @"";
// 根據(jù)財(cái)付通文檔填寫的數(shù)據(jù)和簽名
//這個(gè)比較特殊,是固定的,只能是即req.package = Sign=WXPay
req.package = @"";
// 隨機(jī)編碼,為了防止重復(fù)的,在后臺(tái)生成
req.nonceStr = @"";
// 這個(gè)是時(shí)間戳,也是在后臺(tái)生成的,為了驗(yàn)證支付的
NSString * stamp = @"";
req.timeStamp = stamp.intValue;
// 這個(gè)簽名也是后臺(tái)做的
req.sign = @"";
//發(fā)送請(qǐng)求到微信,等待微信返回onResp
[WXApi sendReq:req];
}
這個(gè)JSON里面的數(shù)據(jù)(上面的參數(shù))就是后臺(tái)需要傳給你的,至于怎么來(lái),也有后臺(tái)的文檔,讓他去看下就行啦~~~
{
"appid": "wxb4ba3c02aa476ea1",
"noncestr": "d1e6ecd5993ad2d06a9f50da607c971c",
"package": "Sign=WXPay",
"partnerid": "10000100",
"prepayid": "wx20160218122935e3753eda1f0066087993",
"timestamp": "1455769775",
"sign": "F6DEE4ADD82217782919A1696500AF06"
}
到這里,不出意外的話應(yīng)該都能正常的支付了。流程最重要,理解了就知道怎么做了,強(qiáng)烈建議需要做的朋友們先理理思路,不要急著下手。
PS:這篇文章中,簽名都是在后臺(tái)做的,如果需要在你客戶端做,可以參考下這篇文章,和這篇文章,他們的簽名在客戶端做的,寫的也比較詳細(xì)了。
可能遇到的問(wèn)題
1.如果支付完成后,一直留在微信,那就檢查下URLType中的Scheme設(shè)置問(wèn)題。
2.能夠打開(kāi)微信客戶端,但是打開(kāi)后只有中間一個(gè)白色的 “確定按鈕”,點(diǎn)擊后會(huì)回到客戶端上,如果是這樣,那應(yīng)該是prepayid 參數(shù)的問(wèn)題,過(guò)期了,或者不是真實(shí)的id。代碼沒(méi)有問(wèn)題的。特別注意的是,微信要兩次簽名,兩次~~~~
3.如果APP里面使用了友盟或者ShareSDK做分享,那就不用再導(dǎo)入SDK了,否則會(huì)出現(xiàn)一些詭異的問(wèn)題,例如無(wú)法調(diào)起手機(jī)微信客戶端、無(wú)法調(diào)起微信客戶端web頁(yè)面,調(diào)起了但是一閃而過(guò)。。。這都基本上都是因?yàn)榉窒淼腟DK里面已經(jīng)包括了微信的SDK。所以如果出現(xiàn)詭異的錯(cuò)誤了看看是不是兩個(gè)沖突了!
4.微信支付的單位是分,被坑過(guò)的人都知道了。。。。哎,
如果在集成過(guò)程中遇到什么問(wèn)題,大家可以一起討論下,我記錄這些如果有什么錯(cuò)誤的話也請(qǐng)告訴我!謝謝!