一直聽說微信支付接入很麻煩,實際看了一遍並動手做下來,其實思路還算清晰。這裡把我的記錄整理出來,供大家參考。
1. 帳號與權限
登錄微信開放平台 https://open.weixin.qq.com,註冊開發者帳號並創建一個移動應用(審核通常需要幾個工作日)。一個帳號可創建的應用數量有限,創建完成後還需要單獨申請開通微信支付能力。
2. 官方 Demo
下載地址:https://pay.weixin.qq.com/wiki/doc/api/app/app.php?chapter=11_1。我當時下載下來的 demo 拿來就能跑,幾乎不用調整。
3. 用戶端的五步交互
步驟一:用戶進入商戶 App,選好商品下單並確認購買,進入支付環節。商戶服務後台生成支付訂單,簽名後把數據下發到 App 端。以微信提供的 Demo 為例,見圖 8.1。
步驟二:用戶點擊支付,跳轉到微信界面並調起微信支付,出現確認支付頁面,見圖 8.2。
步驟三:用戶確認收款方與金額,點擊立即支付後進入輸入密碼界面,可選擇零錢或銀行卡付款,見圖 8.3。

圖 8.1 商戶 App 界面實例

圖 8.2 跳轉到微信支付
圖 8.3 用戶確認支付

步驟四:輸入正確密碼後支付完成,微信出現支付詳情頁,見圖 8.4。
步驟五:回跳到商戶 App,App 根據支付結果個性化展示訂單處理結果,見圖 8.5。

圖 8.4 支付成功提示頁面

圖 8.5 返回商戶 App 提示
4. 後台業務流程

圖 8.6 App 支付時序圖
商戶系統與微信支付系統的主要交互說明:
步驟一:用戶在商戶 App 中選好商品、提交訂單,選擇微信支付。
步驟二:商戶後台收到支付請求,調用微信支付的統一下單接口。
步驟三:統一下單接口返回正常的 prepay_id,再按簽名規範重新生成簽名後把數據下發給 App。參與簽名的字段包括 appId、partnerId、prepayId、nonceStr、timeStamp、package。注意 package 的值格式為 Sign=WXPay。
步驟四:商戶 App 調起微信支付。
步驟五:商戶後台接收支付結果通知。
步驟六:商戶後台主動查詢支付結果,確認最終狀態。
接入時最基本的做法是引入微信 SDK 並做好 URL 回調處理。以 AppDelegate 為例:
#import "AppDelegate.h"
#import "WXApi.h"
#import "WXApiObject.h"
#import "WXApiManager.h"
@interface AppDelegate () <WXApiDelegate>
@end
@implementation AppDelegate
#define APPID @"wxbxxxxxxxxxxx"
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[WXApi registerApp:APPID];
return YES;
}
- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url {
return [WXApi handleOpenURL:url delegate:[WXApiManager sharedManager]];
}
- (BOOL)application:(UIApplication *)application
openURL:(NSURL *)url
sourceApplication:(NSString *)sourceApplication
annotation:(id)annotation {
return [WXApi handleOpenURL:url delegate:[WXApiManager sharedManager]];
}
一個非常容易踩的坑:如果你在 didFinishLaunchingWithOptions 裡手動代碼創建了 window 並設置了 rootViewController,接入微信 SDK 後這段代碼需要注釋掉,否則支付完成回跳時界面會出問題。
// self.window = [[UIWindow alloc] initWithFrame:[UIScreen mainScreen].bounds]; // self.window.backgroundColor = [UIColor whiteColor]; // [self.window makeKeyAndVisible];
支付按鈕的響應方法(V3/V4 流程):
#import "ViewController.h"
#import "WXApiObject.h"
#import "WXApi.h"
@interface ViewController ()
@end
@implementation ViewController
- (IBAction)PayButton:(id)sender {
//============================================================
// V3&V4支付流程實現
// 注意:參數配置請查看服務器端Demo
//============================================================
NSString *urlString = @"https://wxpay.weixin.qq.com/pub_v2/app/app_pay.php?plat=ios";
NSError *error;
//加載一個NSURL對象
NSURLRequest *request = [NSURLRequest requestWithURL:[NSURL URLWithString:urlString]];
//將請求的url數據放到NSData對象中
NSData *response = [NSURLConnection sendSynchronousRequest:request
returningResponse:nil
error:nil];
if (response != nil) {
NSMutableDictionary *dict = NULL;
//iOS5自帶解析類NSJSONSerialization從response中解析出數據放到字典中
dict = [NSJSONSerialization JSONObjectWithData:response
options:NSJSONReadingMutableLeaves
error:&error];
NSLog(@"url:%@", urlString);
if (dict != nil) {
NSMutableString *retcode = [dict objectForKey:@"retcode"];
if (retcode.intValue == 0) {
//調起微信支付
PayReq *req = [[[PayReq alloc] init] autorelease];
//商戶號
req.partnerId = @"10000100";
//預支付交易會話ID
req.prepayId = @"wx2016032814422154f71338a50151536932";
//隨機字符串
req.nonceStr = @"5c95f7583741ee4ba8ae67f1658013dc";
//時間戳
NSMutableString *z = [NSMutableString stringWithFormat:@"1459147341"];
req.timeStamp = z.intValue;
//擴展字段
req.package = [dict objectForKey:@"package"];
//簽名
req.sign = @"22FD8F35A93E5E4EE892CE3638CE4945";
[WXApi sendReq:req];
NSLog(@"appid=%@\npartid=%@\nprepayid=%@\nnoncestr=%@\ntimestamp=%ld\npackage=%@\nsign=%@",
[dict objectForKey:@"appid"], req.partnerId, req.prepayId,
req.nonceStr, (long)req.timeStamp, req.package, req.sign);
}
}
}
}
上面這些參數是照著微信官方 demo 的示例值填的,僅用於跑通流程。
partnerId、prepayId、nonceStr、timeStamp、sign 這五個參數必須由服務端下發,客戶端不要自己拼,簽名也需要服務端用商戶密鑰計算,密鑰絕不能出現在客戶端。sendSynchronousRequest: 是同步請求,會阻塞主線程,實際項目請換成 NSURLSession 或 AFNetworking。以上就是接入微信支付的基本過程。若有描述不當之處,歡迎指出,大家一起交流學習。