首先奉上調(diào)起支付頁面截圖
一:介紹
項(xiàng)目中要用到支付功能日麸,需要支付寶支付寄啼、微信支付、銀聯(lián)支付,所以打算總結(jié)一下墩划,方便以后的查閱涕刚,也方便大家, 用到的地方避免再次被坑乙帮。
今天我們就主要介紹一下微信支付杜漠,其他支付也寫了對應(yīng)教程,并且給出了連接蚣旱。
集成前首先要看看文檔碑幅,微信支付開發(fā)文檔里面有詳細(xì)的字段和說明。
微信支付是需要簽名的塞绿,跟支付寶一樣,可以在客戶端簽名恤批,也可以在后臺簽名(當(dāng)然异吻,為了安全還是推薦在服務(wù)器上做簽名,邏輯也比較好理解)
二:業(yè)務(wù)流程
以下是交互時序圖喜庞,統(tǒng)一下單API诀浪、支付結(jié)果通知API和查詢訂單API等都涉及簽名過程,調(diào)用都必須在商戶服務(wù)器端完成延都。
商戶系統(tǒng)和微信支付系統(tǒng)主要交互說明:
- 用戶在商戶APP中選擇商品雷猪,提交訂單,選擇微信支付晰房。
- 商戶后臺收到用戶支付單求摇,調(diào)用微信支付統(tǒng)一下單接口。
- 統(tǒng)一下單接口返回正常的prepay_id殊者,再按簽名規(guī)范重新生成簽名后与境,將數(shù)據(jù)傳輸給APP。參與簽名的字段名為appid猖吴,partnerid摔刁,prepayid,noncestr海蔽,timestamp钱烟,package五辽。
- 商戶APP調(diào)起微信支付。
- 商戶后臺接收支付通知。
- 商戶后臺查詢支付結(jié)果吴汪。
三:下載微信SDK
微信開放平臺下載SDK
建議把Android頭文件和支付示例都下載下來
四:后臺設(shè)置
商戶在微信開放平臺申請開發(fā)應(yīng)用后,微信開放平臺會生成APP的唯一標(biāo)識APPID缔刹。由于需要保證支付安全愉粤,需要在開放平臺綁定商戶應(yīng)用包名和應(yīng)用簽名,設(shè)置好后才能正常發(fā)起支付。設(shè)置界面在【開放平臺】中的欄目【管理中心 / 修改應(yīng)用 / 修改開發(fā)信息】里面怔软。如下圖:
應(yīng)用包名:是在APP項(xiàng)目配置文件AndroidManifest.xml中聲明的package值垦细,例如DEMO中的。
package="net.sourceforge.simcpux"
應(yīng)用簽名:根據(jù)項(xiàng)目的應(yīng)用包名和編譯使用的keystore挡逼,可由簽名工具生成一個32位的md5串括改,在調(diào)試的手機(jī)上安裝簽名工具后,運(yùn)行可生成應(yīng)用簽名串家坎,如下圖所示嘱能,綠色串即應(yīng)用簽名。
簽名工具下載地址
https://open.weixin.qq.com/zh_CN/htmledition/res/dev/download/sdk/Gen_Signature_Android.apk
net.sourceforge.simcpux 是項(xiàng)目包名
五:導(dǎo)入開發(fā)SDK
導(dǎo)入sdk流程同支付寶導(dǎo)入流程一樣虱疏,這里就借用支付寶導(dǎo)入流程進(jìn)行介紹惹骂。
5.1 如果項(xiàng)目開發(fā)使用的Eclipse軟件,導(dǎo)入步驟如下:
1.將alipaySDK-20150602.jar包放入商戶應(yīng)用工程的libs目錄下做瞪,如下圖对粪。
2.進(jìn)入商戶應(yīng)用工程的Java Build Path,將libs目錄下的alipaySDK-20150602.jar導(dǎo)入装蓬,如下圖著拭。
3.選中Order and Export,勾選alipaySDK-20150602.jar牍帚,如下圖儡遮。
將上圖的支付寶sdk更換成微信sdk即可
5.2 如果項(xiàng)目開發(fā)使用的Android Studio軟件,導(dǎo)入步驟如下:
1.將微信SDK拷貝到項(xiàng)目libs文件夾下暗赶,如果沒有l(wèi)ibs文件夾鄙币,就新建一個。
2.如果sdk使用過程中忆首,提示找不到文件爱榔。
進(jìn)行如下操作,選中sdk文件糙及,右擊選擇Reveal in Finder
六:修改AndroidManifest.xml配置
1.在商戶應(yīng)用工程的AndroidManifest.xml文件里面添加聲明:
<!--微信-->
<activity
android:name=".wxapi.WXPayEntryActivity"
android:exported="true"
android:launchMode="singleTop">
</activity>
和權(quán)限聲明:
<!--微信-->
<uses-permission android:name="android.permission.INTERNET"/>
到這里详幽,微信支付的前期配置已經(jīng)完成,下面需要完成支付代碼編寫浸锨。
七:支付接口調(diào)用
- 在點(diǎn)擊支付按鈕的點(diǎn)擊事件中唇聘,我提供的是從后端獲取訂單信息。
- 需要在新線程中調(diào)用支付接口柱搜。代碼如下:
// 微信按鈕
public void onClick(View view) {
//起一個線程
Runnable payRunnable = new Runnable() {
@Override
public void run() {
String data = null;
PayBean payBean = new PayBean();
payBean.setOrderTime("");
String json = new Gson().toJson(payBean);
//json為獲取后端結(jié)果時需要提供給后端訂單信息迟郎,例如:時間、金額聪蘸、訂單屬性等
Log.i("charge request", json);
try {
//data為后端返回?cái)?shù)據(jù)宪肖,其中包括訂單字符串
data = postJson(CHARGE_URL, json);
} catch (IOException e) {
e.printStackTrace();
}
// Json解析data
ChargeWXBean charge = new Gson().fromJson(data.replace("package", "packages"), ChargeWXBean.class);
//在mHandler中處理微信調(diào)起支付和返回結(jié)果回調(diào)
Message msg = new Message();
msg.what = SDK_PAY_WECHAT;
msg.obj = charge;
mHandler.sendMessage(msg);
}
};
// 必須異步調(diào)用
Thread payThread = new Thread(payRunnable);
payThread.start();
}
- 在mHandler中處理調(diào)起支付
private Handler mHandler = new Handler() {
public void handleMessage(Message msg) {
if (msg.what == SDK_PAY_WECHAT) {
ChargeWXBean charge = (ChargeWXBean) msg.obj;
String packsges = charge.getResult().getCredential().getPackages();
String appid = charge.getResult().getCredential().getAppid();
String partenerid = charge.getResult().getCredential().getPartnerid();
String prepayid = charge.getResult().getCredential().getPrepayid();
String noncestr = charge.getResult().getCredential().getNoncestr();
String timestamp = charge.getResult().getCredential().getTimestamp();
String sign = charge.getResult().getCredential().getSign();
// 商戶APP工程中引入微信JAR包表制,調(diào)用API前,需要先向微信注冊您的APPID控乾,代碼如下:
final IWXAPI msgApi = WXAPIFactory.createWXAPI(ThirdActivity.this, null);
// 將該app注冊到微信
msgApi.registerApp(appid);
PayReq req = new PayReq();
req.appId = appid;
req.partnerId = partenerid;
req.prepayId = prepayid;
req.nonceStr = noncestr;
req.timeStamp = timestamp;
req.packageValue = packsges;
req.sign = sign;
msgApi.sendReq(req);
}
}
};
- 支付結(jié)果回調(diào)
參照微信SDK Sample么介,在net.sourceforge.simcpux.wxapi包路徑中實(shí)現(xiàn)WXPayEntryActivity類(包名或類名不一致會造成無法回調(diào)),在WXPayEntryActivity類中實(shí)現(xiàn)onResp函數(shù)蜕衡,支付完成后壤短,微信APP會返回到商戶APP并回調(diào)onResp函數(shù),開發(fā)者需要在該函數(shù)中接收通知慨仿,判斷返回錯誤碼久脯,如果支付成功則去后臺查詢支付結(jié)果再展示用戶實(shí)際支付結(jié)果。注意一定不能以客戶端返回作為用戶支付的結(jié)果镰吆,應(yīng)以服務(wù)器端的接收的支付通知或查詢API返回的結(jié)果為準(zhǔn)帘撰。(net.sourceforge.simcpux為你的項(xiàng)目包名)代碼示例如下:
@Override
public void onResp(BaseResp resp) {
Log.d(TAG,"onPayFinish,errCode="+resp.errCode);
// 判斷resultStatus 為“0”則代表支付成功,具體狀態(tài)碼代表含義可參考接口文檔
if (resp.errCode.equals("0")) {
Toast.makeText(ThirdActivity.this, "支付成功", Toast.LENGTH_SHORT).show();
}else if (resp.errCode.equals("-1")){
// -1為支付失敗万皿,包括用戶主動取消支付骡和,或者系統(tǒng)返回的錯誤
Toast.makeText(ThirdActivity.this, "支付失敗", Toast.LENGTH_SHORT).show();
}else if (resp.errCode.equals("-2")){
// -2為取消支付,或者系統(tǒng)返回的錯誤
Toast.makeText(ThirdActivity.this, "取消支付", Toast.LENGTH_SHORT).show();
}else {
// 其他為系統(tǒng)返回的錯誤
Toast.makeText(ThirdActivity.this, "支付錯誤", Toast.LENGTH_SHORT).show();
}
}
以下三種為常用結(jié)果判斷
0為支付成功
-1為支付失敗
-2為取消支付