03.07 支付寶APP支付集成文檔

一、開發前提

適用於商家在App應用中集成支付寶支付功能。商家APP調用支付寶提供的SDK調用支付寶客戶端內的支付模塊,商家APP會跳轉到支付寶中完成支付,支付完後跳回到商家APP內,最後展示支付結果。

本文檔旨在指導開發者快速集成支付寶APP支付,包括開簽約APP支付、服務器配置以及安卓端配置。

1、簽約APP支付

APP要想接入支付寶支付功能需要簽約支付寶的APP支付,簽約要符合申請的條件,根據操作提示完成申請,等待審核通過即可

簽約鏈接:https://b.alipay.com/signing/productScene.htm?sceneId=wysk&navKey=wysk

如圖:

支付寶APP支付集成文檔

支付寶APP支付集成文檔

2、創建應用並獲取APPID

然後創建應用,創建成功後即可獲取到APPID創建應用地址:https://openhome.alipay.com/platform/appCreate.htm

如圖:

支付寶APP支付集成文檔

支付寶APP支付集成文檔

3、添加功能

創建應用之後,還有給應用添加APP支付功能

如圖:

支付寶APP支付集成文檔

勾選APP支付,確定即可

支付寶APP支付集成文檔

4、上線應用

根據提示提交審核,等待審核通過即可,注意:測試APP支付必須上線應用,因為沙箱測試不能測試APP支付,可能出現ALI40247錯誤,見鏈接:https://openclub.alipay.com/read.php?tid=250&fid=2https://support.open.alipay.com/support/hotProblemDetail.htm?spm=a219a.7386797.0.0.BZfVkv&id=259972

點擊上線,按照提示完成操作即可,如圖:

支付寶APP支付集成文檔

5、配置密鑰

參考鏈接:https://doc.open.alipay.com/doc2/detail.htm?treeId=200&articleId=105310&docType=1

點擊這裡下載一鍵生成RSA密鑰工具

生成之後,Java開發找到pkcs8格式的私鑰簽名,去除頭尾、換行和空格,作為開發者私鑰

支付寶APP支付集成文檔

將公鑰去除頭尾、換行和空格,填入如圖所示的地方

支付寶APP支付集成文檔

填寫之後,可以驗證公鑰的正確性, 根據圖示操作即可:

支付寶APP支付集成文檔

6、瞭解業務流程

支付寶APP支付集成文檔

二、服務器配置

參考文檔:https://doc.open.alipay.com/doc2/detail?treeId=54&articleId=103419&docType=1

1、下載SDK

服務器SDK有不同的開發語言版本,下載相應的版本,如圖:

支付寶APP支付集成文檔

2、引入jar包

下面以java為例

集成支付寶接口需要引入的文件是:alipay-sdk-java*.jarcommons-logging-1.1.1.jar

若進一步瞭解代碼實現請引入文件:alipay-sdk-java*-source.jarcommons-logging-1.1.1-sources.jar

3、調用示例

傳入服務器創建訂單所需參數參考文檔:https://doc.open.alipay.com/docs/doc.htm?spm=a219a.7629140.0.0.Q48Wtz&treeId=193&articleId=105465&docType=1

參考事例代碼:

<code>//實例化客戶端
AlipayClient client = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do",APP_ID,APP_PRIVATE_KEY,"json","GBK",ALIPAY_PUBLIC_KEY);
//實例化具體API對應的request類,類名稱和接口名稱對應,當前調用接口名稱:alipay.trade.app.pay
AlipayTradeAppPayRequest request = new AlipayTradeAppPayRequest();
//SDK已經封裝掉了公共參數,這裡只需要傳入業務參數
//此次只是參數展示,未進行字符串轉義,實際情況下請轉義
request.setBizContent(" {
\t "primary_industry_name":"IT科技/IT軟件與服務",
\t "primary_industry_code":"10001/20102",
\t "secondary_industry_code":"10001/20102",
\t "secondary_industry_name":"IT科技/IT軟件與服務"
}
");
AlipayTradeAppPayResponse response = client.execute(request);
//調用成功,則處理業務邏輯
if(response.isSuccess()){
\t //.....

}/<code>

三、Android端配置

參考文檔:https://doc.open.alipay.com/docs/doc.htm?spm=a219a.7629140.0.0.rSXklx&treeId=193&articleId=105296&docType=1

1、下載SDK並導入

下載地址:https://doc.open.alipay.com/doc2/detail.htm?treeId=54&articleId=104509&docType=1下載後導入工程中

2、註冊Activity並添加權限

<code><activity>    android:name="com.alipay.sdk.app.H5PayActivity"
android:configChanges="orientation|keyboardHidden|navigation"
android:exported="false"
android:screenOrientation="behind">
/<activity>
<activity> android:name="com.alipay.sdk.auth.AuthActivity"
android:configChanges="orientation|keyboardHidden|navigation"
android:exported="false"
android:screenOrientation="behind">
/<activity>

<uses-permission>
<uses-permission>
<uses-permission>
<uses-permission>
<uses-permission>/<code>

3、添加混淆規則

<code>-libraryjars libs/alipaySDK-20150602.jar
-keep class com.alipay.android.app.IAlixPay{*;}
-keep class com.alipay.android.app.IAlixPay$Stub{*;}
-keep class com.alipay.android.app.IRemoteServiceCallback{*;}
-keep class com.alipay.android.app.IRemoteServiceCallback$Stub{*;}
-keep class com.alipay.sdk.app.PayTask{ public *;}
-keep class com.alipay.sdk.app.AuthTask{ public *;}/<code>

4、調用支付接口

需要在新線程中調用支付接口(可參考alipay_demo實現)獲取PayTask支付對象調用支付(

支付行為需要在獨立的非ui線程中執行),代碼示例:

<code>final String orderInfo = info;   // 訂單信息
Runnable payRunnable = new Runnable() {
@Override
public void run() {
PayTask alipay = new PayTask(DemoActivity.this);
String result = alipay.payV2(orderInfo,true);
Message msg = new Message();
msg.what = SDK_PAY_FLAG;
msg.obj = result;
mHandler.sendMessage(msg);
}
};
// 必須異步調用
Thread payThread = new Thread(payRunnable);
payThread.start();/<code>

5、支付結果獲取和處理

(1)、同步返回

商戶應用客戶端通過當前調用支付的Activity的Handler對象,通過它的回調函數獲取支付結果。(可參考alipay_demo實現)

<code>private Handler mHandler = new Handler() {
public void handleMessage(Message msg) {
Result result = new Result((String) msg.obj);
Toast.makeText(DemoActivity.this, result.getResult(), Toast.LENGTH_LONG).show();
};
};/<code>

(2)、異步通知

商戶需要提供一個http協議的接口,包含在請求支付的入參中,其key對應notify_url。 支付寶服務器在支付完成後,會以POST方式調用notify_url傳輸數據。


分享到:


相關文章: