支付宝APP支付集成文档
一、开发前提
适用于商家在App应用中集成支付宝支付功能。商家APP调用支付宝提供的SDK调用支付宝客户端内的支付模块,商家APP会跳转到支付宝中完成支付,支付完后跳回到商家APP内,最后展示支付结果。
本文档旨在指导开发者快速集成支付宝APP支付,包括开签约APP支付、服务器配置以及安卓端配置。
1、签约APP支付
APP要想接入支付宝支付功能需要签约支付宝的APP支付,签约要符合申请的条件,根据操作提示完成申请,等待审核通过即可
签约链接:https://b.alipay.com/signing/productScene.htm?sceneId=wysk&navKey=wysk
如图:
2、创建应用并获取APPID
然后创建应用,创建成功后即可获取到APPID创建应用地址:https://openhome.alipay.com/platform/appCreate.htm
如图:
3、添加功能
创建应用之后,还有给应用添加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
点击上线,按照提示完成操作即可,如图:
5、配置密钥
参考链接:https://doc.open.alipay.com/doc2/detail.htm?treeId=200&articleId=105310&docType=1
点击这里下载一键生成RSA密钥工具
生成之后,Java开发找到pkcs8格式的私钥签名,去除头尾、换行和空格,作为开发者私钥
将公钥去除头尾、换行和空格,填入如图所示的地方
填写之后,可以验证公钥的正确性, 根据图示操作即可:
6、了解业务流程
二、服务器配置
参考文档:https://doc.open.alipay.com/doc2/detail?treeId=54&articleId=103419&docType=1
1、下载SDK
服务器SDK有不同的开发语言版本,下载相应的版本,如图:
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
参考事例代码:
//实例化客户端
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(" {
"primary_industry_name":"IT科技/IT软件与服务",
"primary_industry_code":"10001/20102",
"secondary_industry_code":"10001/20102",
"secondary_industry_name":"IT科技/IT软件与服务"
}
");
AlipayTradeAppPayResponse response = client.execute(request);
//调用成功,则处理业务逻辑
if(response.isSuccess()){
//.....
}
三、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并添加权限
<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 android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
3、添加混淆规则
-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 *;}
4、调用支付接口
需要在新线程中调用支付接口(可参考alipay_demo实现)获取PayTask支付对象调用支付(支付行为需要在独立的非ui线程中执行),代码示例:
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();
5、支付结果获取和处理
(1)、同步返回
商户应用客户端通过当前调用支付的Activity的Handler对象,通过它的回调函数获取支付结果。(可参考alipay_demo实现)
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();
};
};
(2)、异步通知
商户需要提供一个http协议的接口,包含在请求支付的入参中,其key对应notify_url。 支付宝服务器在支付完成后,会以POST方式调用notify_url传输数据。