Andriod SDK 使用说明

简介

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

下载地址

SDK下载

SDK 版本记录

版本

日期

说明

v1.0.3

2019-08-29

优化查询

v1.0.2

2019-08-22

支持反扫

v1.0.1

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 文件夹下,并在项目中的 build.gradle 中添加:

implementation 'com.tencent.mm.opensdk:wechat-sdk-android-without-mta:+'

使用方法

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

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

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

  • 调用示例

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

参数

描述

activity

发起支付上下文

timeout

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

charge

服务端返回的订单信息

callback

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

参数附表

  • PayResult 支付结果说明

类型

描述

id

Adapay 订单号

amount

订单金额(元)

resultCode

返回码

orderNo

商户订单号

resultMsg

返回结果描述

  • result_code 返回码说明

类型

描述

SUCCESS

订单支付成功

FAILED

订单支付失败

PENDING

订单支付中

CANCEL

用户取消

PARAM_ERROR

参数错误

PAYMENT_ERROR

其他错误