支付宝APP支付集成文档

作者: 掘墓人 | 来源:发表于2017-01-21 00:10 被阅读8061次

    一、开发前提

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

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

    1、签约APP支付

    APP要想接入支付宝支付功能需要签约支付宝的APP支付,签约要符合申请的条件,根据操作提示完成申请,等待审核通过即可

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

    如图:

    APP支付APP支付 APP支付申请条件APP支付申请条件

    2、创建应用并获取APPID

    然后创建应用,创建成功后即可获取到APPID
    创建应用地址:https://openhome.alipay.com/platform/appCreate.htm

    如图:


    创建应用创建应用 获取APPID获取APPID

    3、添加功能

    创建应用之后,还有给应用添加APP支付功能

    如图:

    添加功能添加功能

    勾选APP支付,确定即可

    添加APP支付添加APP支付

    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

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

    上线应用上线应用

    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有不同的开发语言版本,下载相应的版本,如图:

    不同版本服务器SDK不同版本服务器SDK

    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":"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传输数据。

    相关文章

      网友评论

        本文标题:支付宝APP支付集成文档

        本文链接:https://www.haomeiwen.com/subject/cougbttx.html