JS SDK 使用说明

简介

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

下载地址

SDK下载

SDK 版本记录

版本

日期

说明

v1.0.2

2019-08-20

优化接口字段

v1.0.1

2019-08-13

支持 Test模式

v1.0.0

2019-08-08

Adapay 初版

版本要求

  • 支持 PC 大部分主流浏览器。

  • 支持 iOS,Android,微信,支付宝等移动端内核 webview 。

接入方法

  • 下载 SDK 到本地

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

  • 导入 SDK 并引用

将下载后的 JS 文件导入项目中,在引用的文件内加入以下代码:

<script src="AdaPay.min.js" type="text/javascript"></script>

使用方法

客户端通过服务端下单后,将从服务端返回 Charge对象 传入 SDK 发起支付,通过监听 SDK 处理进而获取支付结果。

如使用二维码主扫支付,客户端需解析 Charge对象 中的二维码链接,生成二维码后展示给用户。

其他支付方式,直接发起支付,唤起微信或支付宝 App 后,等待用户支付成功后返回支付结果。

  • 示例代码

AdaPay.doPay(charge, timeout=180, (result)=>{
        console.log("返回结果码....." + result.result_code);
        console.log("返回结果描述....." + result.result_message);
  console.log("返回结果信息....." + result.result_info);
      });
  • 参数说明

参数

描述

charge

服务端返回 Charge对象

timeout

交易结果轮询超时时间,默认 180 秒,可不传

  • 返回结果说明

参数

描述

result_code

异步回调的交易结果码,具体详见附表

result_message

交易结果描述

result_info

服务端返回的交易结果信息,具体详见附表

参数附表

  • order_info 订单信息说明

类型

描述

id

Adapay 订单号

order_amount

订单金额(元)

result_code

返回码

result_message

返回结果描述

  • result_code 返回码说明

类型

描述

succeeded

订单支付成功

failed

订单支付失败

pending

订单支付中

timeout

订单支付超时

cancel

用户取消

paramError

参数错误

unknown

其他错误

注意事项

  • 微信 JSAPI 支付必须在微信浏览器内调试;

  • 接入微信 JSAPI 支付需要额外去 微信公众平台 进行如下配置

    • 配置安全域名用以获取 open_id

    • 配置授权目录用以支付