開發(fā)指引
業(yè)務流程
以下是交互時序圖，統(tǒng)一下單API、支付結(jié)果通知API和查詢訂單API等都涉及簽名過程，調(diào)用都必須在商戶服務器端完成
APP支付時序圖
商戶系統(tǒng)和微信支付系統(tǒng)主要交互說明：
步驟1用戶在商戶APP中選擇商品，提交訂單，選擇微信支付。
步驟2商戶后臺收到用戶支付單，調(diào)用下單接口。參見【統(tǒng)一下單API】。
步驟3下單接口返回正常的prepay_id，再按簽名規(guī)范重新生成簽名后，將數(shù)據(jù)傳輸給APP。
步驟4商戶APP調(diào)起微信支付。api參見【app端開發(fā)步驟說明】
步驟5商戶后臺接收支付通知。api參見【支付結(jié)果通知API】
步驟6商戶后臺查詢支付結(jié)果。api參見【查詢訂單API】.
APP端開發(fā)步驟
IOS開發(fā)要點說明
以下項目開發(fā)環(huán)境以Xcode6.0，運行環(huán)境為IOS7.0為例，說明其開發(fā)中需要的操作。
1)項目設(shè)置APPID
商戶在微信開放平臺申請開發(fā)APP應用后，微信開放平臺會生成APP的唯一標識APPID。在Xcode中打開項目，設(shè)置項目屬性中的URL Schemes為您的APPID。如圖8.7標紅位置所示。
圖8.7
2)注冊APPID
商戶APP工程中引入微信lib庫和頭文件，調(diào)用API前，需要先向微信注冊您的APPID，代碼如下：
[WXApi registerApp:@"wxd930ea5d5a258f4f" withDescription:@"demo 2.0"];3)調(diào)起支付
商戶服務器生成支付訂單，先調(diào)用【下單API】生成預付單，獲取到prepay_id后將參數(shù)再次簽名傳輸給APP發(fā)起支付。以下是調(diào)起微信支付的關(guān)鍵代碼：
PayReq *request = [[[PayReq alloc] init] autorelease];
request.partnerId = @"10000100";
request.prepayId= @"1101000000140415649af9fc314aa427";
request.package = @"Sign=WXPay";
request.nonceStr= @"a462b76e7436e98e0ed6e13c64b4fd1c";
request.timeStamp= @"1397527777";
request.sign= @"582282d72dd2b03ad892830965f428cb16e7a256";
[WXApi safeSendReq:request];注意：該sign生成字段名列表見調(diào)起支付API
4)支付結(jié)果回調(diào)
照微信SDK Sample，在類實現(xiàn)onResp函數(shù)，支付完成后，微信APP會返回到商戶APP并回調(diào)onResp函數(shù)，開發(fā)者需要在該函數(shù)中接收通知，判斷返回錯誤碼，如果支付成功則去后臺查詢支付結(jié)果再展示用戶實際支付結(jié)果。注意 一定不能以客戶端返回作為用戶支付的結(jié)果，應以服務器端的接收的支付通知或查詢API返回的結(jié)果為準。代碼示例如下：
- (void)onResp:(BaseResp *)resp {
if ([resp isKindOfClass:[PayResp class]]) {
PayResp *response = (PayResp *)resp;
switch (response.errCode) {
case WXSuccess:
//Prompt of successful payment according to server-based query result or API returned data
NSlog(@"Payment Successful");
break;
default:
NSlog(@"Payment Failed， retcode=%d",resp.errCode);
break;
}
}
}回調(diào)中errCode值列表：
| 名稱 | 描述 | 解決方案 |
|---|---|---|
| 0 | 成功 | 展示成功頁面 |
| -1 | 錯誤 | 可能的原因：簽名錯誤、未注冊APPID、項目設(shè)置APPID不正確、注冊的APPID與設(shè)置的不匹配、其他異常等。 |
| -2 | 用戶取消 | 無需處理。發(fā)生場景：用戶不支付了，點擊取消，返回APP。 |
Android開發(fā)要點說明
1)后臺設(shè)置
商戶在微信開放平臺申請開發(fā)應用后，微信開放平臺會生成APP的唯一標識APPID。由于需要保證支付安全，需要在開放平臺綁定商戶應用包名和應用簽名，設(shè)置好后才能正常發(fā)起支付。設(shè)置界面在【開放平臺】中的欄目【管理中心 / 修改應用 / 修改開發(fā)信息】里面，如圖8.8紅框內(nèi)所示
圖8.8
應用包名：是在APP項目配置文件AndroidManifest.xml中聲明的package值，例如DEMO中的package="net.sourceforge.simcpux"。
應用簽名：根據(jù)項目的應用包名和編譯使用的keystore，可由簽名工具生成一個32位的md5串，在調(diào)試的手機上安裝簽名工具后，運行可生成應用簽名串，如圖8.9所示，綠色串即應用簽名。簽名工具下載地址https://open.weixin.qq.com/zh_CN/htmledition/res/dev/download/sdk/Gen_Signature_Android.apk
圖8.9
2)注冊APPID
商戶APP工程中引入微信JAR包，調(diào)用API前，需要先向微信注冊您的APPID，代碼如下：
final IWXAPI msgApi = WXAPIFactory.createWXAPI(context, null);
// 將該app注冊到微信
msgApi.registerApp("wxd930ea5d5a258f4f");3)調(diào)起支付
商戶服務器生成支付訂單，先調(diào)用統(tǒng)一下單API(詳見第7節(jié))生成預付單，獲取到prepay_id后將參數(shù)再次簽名傳輸給APP發(fā)起支付。以下是調(diào)起微信支付的關(guān)鍵代碼：
IWXAPI api;
PayReq request = new PayReq();
request.appId = "wxd930ea5d5a258f4f";
request.partnerId = "1900000109";
request.prepayId= "1101000000140415649af9fc314aa427",;
request.packageValue = "Sign=WXPay";
request.nonceStr= "1101000000140429eb40476f8896f4c9";
request.timeStamp= "1398746574";
request.sign= "7FFECB600D7157C5AA49810D2D8F28BC2811827B";
api.sendReq(request);注意：該sign生成字段名列表見調(diào)起支付API
4)支付結(jié)果回調(diào)
參照微信SDK Sample，在net.sourceforge.simcpux.wxapi包路徑中實現(xiàn)WXPayEntryActivity類(包名或類名不一致會造成無法回調(diào))，在WXPayEntryActivity類中實現(xiàn)onResp函數(shù)，支付完成后，微信APP會返回到商戶APP并回調(diào)onResp函數(shù)，開發(fā)者需要在該函數(shù)中接收通知，判斷返回錯誤碼，如果支付成功則去后臺查詢支付結(jié)果再展示用戶實際支付結(jié)果。注意一定不能以客戶端返回作為用戶支付的結(jié)果，應以服務器端的接收的支付通知或查詢API返回的結(jié)果為準。代碼示例如下：
public void onResp(BaseResp resp) {
if (resp.getType() == ConstantsAPI.COMMAND_PAY_BY_WX) {
Log.d(TAG, "onPayFinish, errCode = " + resp.errCode);
AlertDialog.Builder builder = new AlertDialog.Builder(this);
builder.setTitle(R.string.app_tip);
}
}回調(diào)中errCode值列表：
| 名稱 | 描述 | 解決方案 |
|---|---|---|
| 0 | 成功 | 展示成功頁面 |
| -1 | 錯誤 | 可能的原因：簽名錯誤、未注冊APPID、項目設(shè)置APPID不正確、注冊的APPID與設(shè)置的不匹配、其他異常等。 |
| -2 | 用戶取消 | 無需處理。發(fā)生場景：用戶不支付了，點擊取消，返回APP。 |
-
Customer Service Tel
-
Business Development
-
9:00-18:00
Monday-Friday GMT+8
-
Technical Support
WeChat Pay Global
ICP證