Andriod 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 |
其他错误 |