前言
cordova-plugin-alipay-v2(更新至alipaySdk-15.6.5-20190718211148.aar)
支付宝的cordova插件其实在github上已经有很多了,但是都已经是以前的版本了。
在2016年11月的时候支付宝进行了一次更新,支付宝的SDK升级到2.0版本。
以前在app中使用支付宝进行支付叫做移动支付,11月之后更名为APP支付。
本插件仅支持《APP支付》,不支持移动支付
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老版本,请安装插件以前的老版本,在安装的时候带上版本号即可,cordova-plugin-alipay-v2@0.0.4。
功能说明
- 根据支付宝的说明文档的建议,为保证安全,签名都放到后端去做,前端只需要接收后台传入签名字符串,使用该插件调用支付宝SDK完成支付
- APP_ID:对应开放平台中应用的APPID,主要用于iOS平台Xcode构建URL Schemes
支持平台
- android (alipaySdk-15.6.5-20190718211148.aar)
- 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¬ify_url=http%3A%2F%2Fdomain.merchant.com%2Fpayment_notify&sign_type=RSA2×tamp=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分钱来做测试。
如要使用沙箱环境,请自行参考官方文档。