天天看点

支付宝APP支付集成文档一、开发前提二、服务器配置三、Android端配置

一、开发前提

适用于商家在App应用中集成支付宝支付功能。商家APP调用支付宝提供的SDK调用支付宝客户端内的支付模块,商家APP会跳转到支付宝中完成支付,支付完后跳回到商家APP内,最后展示支付结果。

本文档旨在指导开发者快速集成支付宝APP支付,包括开签约APP支付、服务器配置以及安卓端配置。

1、签约APP支付

APP要想接入支付宝支付功能需要签约支付宝的

APP支付

,签约要符合申请的条件,根据操作提示完成申请,等待审核通过即可

签约链接:https://b.alipay.com/signing/productScene.htm?sceneId=wysk&navKey=wysk

如图:

支付宝APP支付集成文档一、开发前提二、服务器配置三、Android端配置
支付宝APP支付集成文档一、开发前提二、服务器配置三、Android端配置

2、创建应用并获取APPID

然后创建应用,创建成功后即可获取到APPID

创建应用地址:https://openhome.alipay.com/platform/appCreate.htm

如图:

支付宝APP支付集成文档一、开发前提二、服务器配置三、Android端配置
支付宝APP支付集成文档一、开发前提二、服务器配置三、Android端配置

3、添加功能

创建应用之后,还有给应用添加

APP支付功能

如图:

支付宝APP支付集成文档一、开发前提二、服务器配置三、Android端配置

勾选APP支付,确定即可

支付宝APP支付集成文档一、开发前提二、服务器配置三、Android端配置

4、上线应用

根据提示提交审核,等待审核通过即可,注意:测试APP支付必须上线应用,因为沙箱测试不能测试APP支付,可能出现

ALI40247错误

,见链接:

https://openclub.alipay.com/read.php?tid=250&fid=2

https://support.open.alipay.com/support/hotProblemDetail.htm?spm=a219a.7386797.0.0.BZfVkv&id=259972

点击上线,按照提示完成操作即可,如图:

支付宝APP支付集成文档一、开发前提二、服务器配置三、Android端配置

5、配置密钥

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

点击这里下载一键生成RSA密钥工具

生成之后,Java开发找到

pkcs8

格式的私钥签名,去除头尾、换行和空格,作为开发者私钥

支付宝APP支付集成文档一、开发前提二、服务器配置三、Android端配置

将公钥去除头尾、换行和空格,填入如图所示的地方

支付宝APP支付集成文档一、开发前提二、服务器配置三、Android端配置

填写之后,可以验证公钥的正确性, 根据图示操作即可:

支付宝APP支付集成文档一、开发前提二、服务器配置三、Android端配置

6、了解业务流程

支付宝APP支付集成文档一、开发前提二、服务器配置三、Android端配置

二、服务器配置

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

1、下载SDK

服务器SDK有不同的开发语言版本,下载相应的版本,如图:

支付宝APP支付集成文档一、开发前提二、服务器配置三、Android端配置

2、引入jar包

下面以java为例

集成支付宝接口需要引入的文件是:

alipay-sdk-java*.jar

commons-logging-1.1.1.jar

若进一步了解代码实现请引入文件:

alipay-sdk-java*-source.jar

commons-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":"/",
     "secondary_industry_code":"/",
     "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-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传输数据。