Andriod SDK 使用文档¶
SDK 版本记录¶
版本 |
日期 |
说明 |
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 |
其他错误 |