支付宝接入流程
导入开发资源
将alipaySdk-xxxxxxxx.jar包放入商户应用工程的libs目录下
修改Manifest
在商户应用工程的AndroidManifest.xml文件里面添加声明:
// 支付界面
android:name="com.alipay.sdk.app.H5PayActivity"
android:configChanges="orientation|keyboardHidden|navigation|screenSize"
android:exported="false"
android:screenOrientation="behind"
android:windowSoftInputMode="adjustResize|stateHidden" >
//认证界面
android:name="com.alipay.sdk.app.H5AuthActivity"
android:configChanges="orientation|keyboardHidden|navigation"
android:exported="false"
android:screenOrientation="behind"
android:windowSoftInputMode="adjustResize|stateHidden" >
权限声明
添加混淆
在商户应用工程的proguard-project.txt里添加以下相关规则:
-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 *;}
-keep class com.alipay.sdk.app.H5PayCallback {
;
;
}
-keep class com.alipay.android.phone.mrpc.core.** { *; }
-keep class com.alipay.apmobilesecuritysdk.** { *; }
-keep class com.alipay.mobile.framework.service.annotation.** { *; }
-keep class com.alipay.mobilesecuritysdk.face.** { *; }
-keep class com.alipay.tscenter.biz.rpc.** { *; }
-keep class org.json.alipay.** { *; }
-keep class com.alipay.tscenter.** { *; }
-keep class com.ta.utdid2.** { *;}
-keep class com.ut.device.** { *;}
支付接口调用
需要在新线程中调用支付接口
PayTask对象主要为商户提供订单支付、查询功能,及获取当前开发包版本号。
获取PayTask支付对象调用支付
final String orderInfo = info; // 给服务器传递订单id和总价格,由服务器返回的签名后的订单信息
Runnable payRunnable = new Runnable() { //支付行为需要在独立的非ui线程中执行
@Override
public void run() {
PayTask alipay = new PayTask(DemoActivity.this);
//payV2 参数说明
// orderInfo : app支付请求参数字符串,主要包含商户的订单信息,key=value形式,以&连接。获取必须来源于服务端
//isShowPayLoading : 用户在商户app内部点击付款,是否需要一个loading做为在钱包唤起之前的过渡,
这个值设置为true,将会在调用pay接口的时候直接唤起一个loading,直到唤起H5支付页面或者唤起外部的钱包付款页面loading才消失。
(建议将该值设置为true,优化点击付款到支付唤起支付页面的过渡过程。)
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();
支付结果获取和处理
调用pay方法支付后,将通过2种途径获得支付结果:
同步返回
同步异步通知参数
商户应用客户端通过当前调用支付的Activity的Handler对象,通过它的回调函数获取支付结果。就是上面的mHandle
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();
};
};
同步返回的数据,商户可以按照下文描述的方式在服务端验证,验证通过后,可以认为本次用户付款成功。
有些时候会出现商户app在支付宝付款阶段被关闭导致无法正确收到同步结果,此时支付结果可以完全依赖服务端的异步通知。
一般支付结果,以服务器的返回结果为准
返回示例
memo是描述信息(类型为字符串);
result是处理结果(类型为json结构字符串);
resultStatus是结果码(类型为字符串)。
{
"memo" : "xxxxx",
"result" : "{
\"alipay_trade_app_pay_response\":{
\"code\":\"10000\",
\"msg\":\"Success\",
\"app_id\":\"2014072300007148\",
\"out_trade_no\":\"081622560194853\",
\"trade_no\":\"2016081621001004400236957647\",
\"total_amount\":\"0.01\",
\"seller_id\":\"2088702849871851\",
\"charset\":\"utf-8\",
\"timestamp\":\"2016-10-11 17:43:36\"
},
\"sign\":\"NGfStJf3i3ooWBuCDIQSumOpaGBcQz+aoAqyGh3W6EqA/gmyPYwLJ2REFijY9XPTApI9YglZyMw+ZMhd3kb0mh4RAXMrb6mekX4Zu8Nf6geOwIa9kLOnw0IMCjxi4abDIfXhxrXyj********\",
\"sign_type\":\"RSA2\"
}",
"resultStatus" : "9000"
}
结果码说明:
9000 订单支付成功
8000 正在处理中,支付结果未知(有可能已经支付成功),请查询商户订单列表中订单的支付状态
4000 订单支付失败
5000 重复请求
6001 用户中途取消
6002 网络连接出错
6004 支付结果未知(有可能已经支付成功),请查询商户订单列表中订单的支付状态
其它 其它支付错误
异步返回
商户需要提供一个http协议的接口,包含在请求支付的入参中,其key对应notify_url。
支付宝服务器在支付完成后,会以POST方式调用notify_url传输数据。
App支付请求参数说明 ,一般是客户端传递orderId和totalPrice给服务端,服务端生成,签名,然后返回
外部商户App唤起快捷SDK创建订单并支付
请求参数是商户在与支付宝进行数据交互时,提供给支付宝的请求数据,以便支付宝根据这些数据进一步处理
请求参数说明