Andriod SDK 使用文档

简介

Adapay Android SDK 支持的渠道包含:支付宝 App 支付(alipay)、微信支付宝当面付(主扫)支付。具体可参考 API文档

下载地址

SDK下载

SDK 版本记录

版本

日期

说明

v1.0.4

2020-01-07

优化调用

v1.0.3

2019-08-29

支持反扫

v1.0.2

2019-08-13

支持 Test模式

v1.0.0

2019-08-08

Adapay 初版

版本要求

此 SDK 要求 Android 4.1 及以上版本,且请使用 Java 8 及以上版本。

接入方法

1.下载 SDK 到本地

下载文件里包含 SDK 和 Demo 两个目录。SDK 目录下为待添加到项目中的文件,Demo 目录下为示例项目,供接入时参考使用。

2.权限声明

修改 AndroidManifest.xml 文件

<!-- 添加以下权限 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.INTERNET" />

3.导入 Adapay SDK

将 adapay_XXX.aar 包放在 App 下的 libs 文件夹下,并在 app 中的 build.gradle 添加:

android{
    ...
    repositories {
        flatDir {
            dirs 'libs'
        }
    }
    ...
}

使用方法

发起任何形式的支付时调用此方法,目前支持的支付方式有微信/支付宝二维码正扫,支付宝 App 支付。Payment 是一个包含支付信息的 JSON 字符串,在请求服务端后由服务端生成。

如果为二维码支付,获取到 Payment 后,解析出其中的二维码 url(qrcode_url字段) 即可生成二维码并展示,之后调用此方法进行支付。

如果为 App 支付,直接调用此方法即可。

  • 调用示例

AdaPay.doPay(MainActivity.this, "payment json string", new PayCallback() {
    @Override
    public void onPayment(PayResult payResult) {
        //处理支付结果
    }
});
  • 参数说明

参数

描述

activity

发起支付上下文

timeout

支付结果查询超时时间(默认 180 秒,从调用此方法开始计时)

payment

服务端返回的订单信息

callback

支付结果回调,回调信息参照支付结果

参数附表

  • PayResult 支付结果说明

类型

描述

payment_id

Adapay 订单号

payment_amt

订单金额(元)

result_code

返回码

order_no

商户订单号

result_msg

返回结果描述

  • result_code 返回码说明

类型

描述

0000

订单支付成功

0001

订单支付失败

0002

订单支付中

0013

用户取消

0020

参数错误

0031

网络出错

0032

其他错误