pingpp
来自于:ping++立即使用
createPayment getVersion setDebugMode getPingppVersion setSEPay setUniversalLink
概述
pingpp 封装了支付宝(alipay),微信(wx),银联(upacp),百度钱包(bfb_wap)四个渠道的支付接口。使用此模块可轻松实现各个渠道的支付功能。
使用之前需要先到 Ping++ 注册,并根据技术文档部署 Server SDK。
注意
- 使用此模块时,请勿同时勾选 aliPay 模块;
- 如果需要使用微信支付,请同时添加
wxPlus
模块,并确保在调用支付前调用setUniversalLink
方法; - 本模块需要配合其他含阿里 utdid 包的模块才能正常使用。或者使用 utdid 自定义模块(版本 1.0.3)(需要修改 module.json 内容,添加一对大括号{})
createPayment
调用 Ping++ SDK
params
charge:
- 类型:字符串
- 描述:从 Server SDK 获取到的 charge 对象 JSON 序列化字符串
scheme:
- 类型:字符串
- 描述:自定义的 iOS URL Schemes,请在 config.xml 添加,配置方法参考文档。Android 平台不需要。
callback(ret, err)
ret:
- 类型:字符串
内部字段:
{
"result": "success" // 结果:"success", "fail", "cancel", "invalid"
}
微信客户端未安装时会返回 invalid
,建议提前判断是否有安装微信,而不是根据这个返回结果去提示用户。
err:
- 类型:JSON 对象
内部字段:
{
"code": 0, // 错误码
"msg": "" // 错误描述
}
错误码:
0: 无效的 Charge;
1: 无效的 Credential;
2: 无效的渠道;
3: 微信客户端未安装;
4: 微信客户端版本不支持 OpenApi;
5: 取消;
6: 找不到 ViewController;(仅在 iOS 出现)
7: 测试模式异步通知失败;
8: 渠道返回失败;
9: 网络错误;
10: 未知错误。
实例代码
var pingpp = api.require('pingpp');
var params = {
charge: chargeJSONString,
scheme: "yourappurlscheme"
};
pingpp.createPayment(params, function(ret, err){
if (ret.result == "success") {
api.alert({msg:"success"});
}
});
补充说明
- 百度钱包渠道字段,请用
bfb_wap
。iOS 使用该渠道时,会跳出应用到浏览器,请在结果页面跳转到yourappurlscheme://pingppwappay?result=success
来返回应用。Android 使用该渠道,请在结果页面用 JS 调用PingppAndroidSDK.setResult("success");
来返回你的页面。
可用性
iOS 系统,Android 系统
getVersion
获取版本号
实例代码
var pingpp = api.require('pingpp');
var version = pingpp.getVersion();
补充说明
无
可用性
iOS 系统,Android 系统
setDebugMode
设置是否开启 Debug 模式
params
enabled:
- 类型:布尔型
- 描述:是否开启 Debug 模式
实例代码
var pingpp = api.require('pingpp');
pingpp.setDebugMode({enabled:true});
补充说明
无
可用性
iOS 系统,Android 系统
getPingppVersion
获取版本号
实例代码
var pingpp = api.require('pingpp');
var version = pingpp.getPingppVersion();
补充说明
无
可用性
iOS 系统,Android 系统
setSEPay
设置是否允许使用手机 Pay
params
enabled:
- 类型:布尔型
- 描述:是否允许使用手机 Pay
实例代码
var pingpp = api.require('pingpp');
pingpp.setSEPay({enabled:false});
补充说明
无
可用性
Android 系统
setUniversalLink
设置微信支付的 Universal Link
params
universalLink:
- 类型:字符串
- 描述:微信支付的 Universal Link
实例代码
var pingpp = api.require('pingpp');
pingpp.setUniversalLink({universalLink: "https://app.example.com/"});
补充说明
无
可用性
iOS 系统