JS SDK 使用文档

简介

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

下载地址

SDK下载

SDK 版本记录

版本

日期

说明

v1.0.5

2020-04-03

优化调用

v1.0.4

2020-01-15

优化调用

v1.0.3

2019-09-05

支持 Test模式

v1.0.2

2019-08-25

优化调用

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>

使用方法

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

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

为确保 Adapay 与微信或支付宝内置对象已成功加载完成,建议使用按钮点击事件触发 SDK 方法调用(切勿一进入页面就直接调用)。

**微信公众号支付请阅读 注意事项 内容 **

  • 示例代码

调用示例可参考 线上demo (请在手机端打开,微信公众号请在微信内打开)

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

参数

描述

payment

服务端返回 Payment对象

  • 返回结果说明

参数

描述

result_status

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

result_message

交易结果描述

result_info

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

参数附表

  • result_info 订单信息说明

类型

描述

id

Adapay 订单号

order_amount

订单金额(元)

result_status

返回码

result_message

返回结果描述

  • result_status 返回码说明

类型

描述

succeeded

订单支付成功

failed

订单支付失败

pending

订单支付中

timeout

订单支付超时

cancel

用户取消

paramError

参数错误

unknown

其他错误

注意事项

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

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

    • 配置授权回调安全域名用以获取 open_id

    • 配置支付授权目录用以支付(可在 Adapay 控制台,亦可在微信公众平台配置)