googlePay
init isReadyToPay requestPayment
概述
此模块封装了googlePay,借助 Google Pay,您的客户只需按下按钮即可使用保存在其 Google 帐号中的付款方式完成付款。
模块接口
init
初始化
init({params},callback(ret))
params
production:
- 类型:布尔类型
- 描述:是否是生产环境
- 默认:false
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
status:, //布尔类型;是否成功初始化
}
err:
- 类型:JSON 对象
- 内部字段:
{
msg:, //字符串类型;错误信息
}
示例代码
var googlePay = api.require('googlePay');
googlePay.init({
production:,
}, function(ret, err) {
alert(JSON.stringify(ret));
});
可用性
Android系统
可提供的1.0.0及更高版本
isReadyToPay
确定是否能使用 Google Pay API 进行付款
isReadyToPay({params},callback(ret))
params
request:
- 类型:Json对象类型
- 描述:判断是否可以用googlePay的参数,详情见googlePay对象参考
- 例:
{apiVersion:2, //数字类型;主要 API 版本。对于此规范,该值为 2
apiVersionMinor:0, //数字类型;次要 API 版本。对于此规范,该值为 0。
allowedPaymentMethods:[
{
type:'CARD',
parameters:{
billingAddressRequired:true, //布尔类型;是否要求提供账单邮寄地址
billingAddressParameters:{ //Json对象类型;设置账单邮寄地址其他字段
format:'', //字符串类型;‘MIN’ 或者 ‘FULL’
phoneNumberRequired:, //布尔类型是否要求提供电话号码
},
allowedAuthMethods:[ //Json数组类型;
'PAN_ONLY','CRYPTOGRAM_3DS'
],
allowedCardNetworks:[ //Json数组类型;支付卡网络
'AMEX','DISCOVER','INTERAC','JCB','MASTERCARD','VISA'
]
},
},
]
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
status:, //布尔类型;是否能使用 Google Pay API 进行付款
}
err:
- 类型:JSON 对象
- 内部字段:
{
msg:, //字符串类型;错误信息
}
示例代码
var googlePay = api.require('googlePay');
googlePay.isReadyToPay({
request:{},
}, function(ret, err) {
alert(JSON.stringify(ret));
});
可用性
Android系统
可提供的1.0.0及更高版本
requestPayment
请求付款
requestPayment({params},callback(ret))
params
paymentData:
- 类型:Json对象类型
- 描述:付款参数;详情见googlePay对象参考
- 例:
{
allowedPaymentMethods:[
{
tokenizationSpecification:{ //Json对象类型;配置要接收可扣款付款信息的帐号
type:'PAYMENT_GATEWAY', //字符串类型;付款方式
parameters:{ //Json对象类型;令牌化类型所特有的参数
gateway:'example',
gatewayMerchantId:'exampleGateway' //字符串类型;MerchantId
}
}
},
],
transactionInfo:{ //Json对象类型;交易授权的详细信息
totalPrice:'', //字符串类型;价格
totalPriceLabel:'', //字符串类型;总价的自定义标签
checkoutOption:'', //字符串类型;提交按钮文本
currencyCode:'', //字符串类型;ISO 4217 字母货币代码
totalPriceStatus:'', //字符串类型;总价状态
},
merchantInfo:{ //Json对象类型;商家信息
merchantId:'', //字符串类型;商家id
merchantName:'', //字符串类型;商家名称
merchantOrigin:'', //字符串类型;商家完全限定域名
},
shippingAddressRequired:true,
shippingAddressParameters:{ //Json对象类型;送货限制
allowedCountryCodes:[], //Json数组类型;允许送货的国家/地区的 ISO 3166-1 alpha-2 国家/地区代码值
phoneNumberRequired:, //布尔类型;是否需要填写电话号码
}
}
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
status:, //布尔类型;是否可付款
paymentInfo:{}, //Json对象类型;可获取支付方式,支付token,收款人等信息。
}
err:
- 类型:JSON 对象
- 内部字段:
{errCode:, //数字类型;错误码
msg:, //字符串类型;错误信息
}
示例代码
var googlePay = api.require('googlePay');
googlePay.requestPayment({
paymentData:{},
}, function(ret, err) {
alert(JSON.stringify(ret));
});
可用性
Android系统
可提供的1.0.0及更高版本