Skip to content

Latest commit

 

History

History
139 lines (108 loc) · 5.35 KB

README.md

File metadata and controls

139 lines (108 loc) · 5.35 KB
Raw

cordova-plugin-alipay-v2（更新至alipaysdk-15.8.00.201112210139.aar）

支付宝的cordova插件其实在github上已经有很多了，但是都已经是以前的版本了。 在2016年11月的时候支付宝进行了一次更新，支付宝的SDK升级到2.0版本。 以前在app中使用支付宝进行支付叫做移动支付，11月之后更名为APP支付。

本插件仅支持《APP支付》，不支持移动支付

2020-12-05 更新日志

  • SDK 更新至alipaysdk-15.8.00.201112210139.aar。
  • 将 AlipaySDK 中的 UIWebView 更换为 WKWebView。
  • 支持 iOS Universal Link，提高支付稳定性。

2019-07-31 更新日志

  • Android SDK 更新至alipaySdk-15.6.5-20190718211148.aar。
  • iOS SDK 已适配 iPhoneX，支持 IPv6_only 网络和 ATS 安全标准。

2018-11-28 更新日志

最近总有人问在iOS上没有回调的问题，真机实测不存在该问题。

第一步：在Xcode中检查project的Bundle Identifier是否与其他项目重名。

第二步：在Xcode中检查project的URL Types上alipay的URL Schemes格式是否正确。 Xcode的URL Types上alipay的URL Schemes正确格式应为 ali2xxxxxxxxxxxxxxx。 2开头的这串数字是你的APP_ID，英文字母与数字之间没有任何符号！！！

第三步：检查调用插件写法是否正确。

ionic1上的建议写法

var payInfo = "xxx";
cordova.plugins.alipay.payment(payInfo, function success(e){
    // TODO 支付成功
},function error(e){
    //TODO 支付失败
    console.log("支付失败" + e.resultStatus);
});

ionic3上的建议写法

let payInfo = "xxx";
cordova.plugins.alipay.payment(payInfo, (e) => {
  //TODO 支付成功

}, (e) => {
  //TODO 支付失败
  console.log(e.resultStatus);
});

注意

插件从v1.0.0开始支持cordova-android 7.0.0，因为cordova-android 7.0.0更改了android项目的文件目录，所以不再兼容以前的老版本，升级前请务必注意。

如果项目是之前的cordova-android老版本，请安装插件以前的老版本，在安装的时候带上版本号即可,[email protected]。

#功能说明

  1. 根据支付宝的说明文档的建议，为保证安全，签名都放到后端去做，前端只需要接收后台传入签名字符串，使用该插件调用支付宝SDK完成支付
  2. APP_ID：对应开放平台中应用的APPID，主要用于iOS平台Xcode构建URL Schemes

支持平台

  1. android （alipaySdk-15.6.5-20190718211148.aar）
  2. iOS （Xcode版本须大于7.0，iOS版本须大于或等于9.0）

安装

在线安装

npm安装

cordova plugin add cordova-plugin-alipay-v2 --variable APP_ID=your AppId

git安装

cordova plugin add https://github.com/hhjjj1010/cordova-plugin-alipay-v2.git --variable APP_ID=your AppId

本地安装

下载插件到本地

cordova plugin add /your/local/path --variable APP_ID=your AppId

使用 API

第一步：订单在服务端签名生成订单信息，具体请参考官网进行订单签名

带有签名信息的订单信息示例

var payInfo = "app_id=2015052600090779&biz_content=%7B%22timeout_express%22%3A%2230m%22%2C%22product_code%22%3A%22QUICK_MSECURITY_PAY%22%2C%22total_amount%22%3A%220.01%22%2C%22subject%22%3A%221%22%2C%22body%22%3A%22%E6%88%91%E6%98%AF%E6%B5%8B%E8%AF%95%E6%95%B0%E6%8D%AE%22%2C%22out_trade_no%22%3A%22IQJZSRC1YMQB5HU%22%7D&charset=utf-8&format=json&method=alipay.trade.app.pay&notify_url=http%3A%2F%2Fdomain.merchant.com%2Fpayment_notify&sign_type=RSA2&timestamp=2016-08-25%2020%3A26%3A31&version=1.0&sign=cYmuUnKi5QdBsoZEAbMXVMmRWjsuUj%2By48A2DvWAVVBuYkiBj13CFDHu2vZQvmOfkjE0YqCUQE04kqm9Xg3tIX8tPeIGIFtsIyp%2FM45w1ZsDOiduBbduGfRo1XRsvAyVAv2hCrBLLrDI5Vi7uZZ77Lo5J0PpUUWwyQGt0M4cj8g%3D";

第二步：调用支付插件

ionic1 代码示例

cordova.plugins.alipay.payment(payInfo,function success(e){
  // 支付成功

},function error(e){
  //TODO 支付失败
  console.log("支付失败" + e.resultStatus);
});

ionic3 代码示例

ionic3上使用时须在import结束后添加 declare let cordova。

cordova.plugins.alipay.payment(payInfo, (e) => {
  //TODO 支付成功

}, (e) => {
      //TODO 支付失败
      console.log("支付失败" + e.resultStatus);
    });

回调函数参数说明

e.resultStatus 状态代码 e.result 本次操作返回的结果数据 e.memo 提示信息

e.resultStatus：9000 订单支付成功；8000 正在处理中；调用function success

error.resultStatus：4000 订单支付失败；6001 用户中途取消；6002 网络连接出错 ；调用function error

当e.resultStatus为9000时，请去服务端验证支付结果,建议商户依赖异步通知 同步返回的结果必须放置到服务端进行验证，具体请查看验证的规则 。

TIPS

1. iOS上支付成功之后无法回调

Xcode的URL Types上alipay的URL Schemes正确格式应为ali2xxxxxxxxxxxxxxx。2开头的这串数字是你的APP_ID，英文字母与数字之间没有任何符号！！！

2. 沙箱环境

在我个人的开发过程中确实是没有使用到沙箱环境，都是直接真实支付1分钱来做测试。 如要使用沙箱环境，请自行参考官方文档。