googlePay

立即使用

init isReadyToPay requestPayment

概述

此模块封装了googlePay,借助 Google Pay,您的客户只需按下按钮即可使用保存在其 Google 帐号中的付款方式完成付款。

模块接口

init

初始化

init({params},callback(ret))

params

production:

  • 类型:布尔类型
  • 描述:是否是生产环境
  • 默认:false

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:, //布尔类型;是否成功初始化
  3. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. msg:, //字符串类型;错误信息
  3. }

示例代码

  1. var googlePay = api.require('googlePay');
  2. googlePay.init({
  3. production:,
  4. }, function(ret, err) {
  5. alert(JSON.stringify(ret));
  6. });

可用性

Android系统

可提供的1.0.0及更高版本

isReadyToPay

确定是否能使用 Google Pay API 进行付款

isReadyToPay({params},callback(ret))

params

request:

  • 类型:Json对象类型
  • 描述:判断是否可以用googlePay的参数,详情见googlePay对象参考
  • 例:
  1. {apiVersion:2, //数字类型;主要 API 版本。对于此规范,该值为 2
  2. apiVersionMinor:0, //数字类型;次要 API 版本。对于此规范,该值为 0。
  3. allowedPaymentMethods:[
  4. {
  5. type:'CARD',
  6. parameters:{
  7. billingAddressRequired:true, //布尔类型;是否要求提供账单邮寄地址
  8. billingAddressParameters:{ //Json对象类型;设置账单邮寄地址其他字段
  9. format:'', //字符串类型;‘MIN’ 或者 ‘FULL’
  10. phoneNumberRequired:, //布尔类型是否要求提供电话号码
  11. },
  12. allowedAuthMethods:[ //Json数组类型;
  13. 'PAN_ONLY','CRYPTOGRAM_3DS'
  14. ],
  15. allowedCardNetworks:[ //Json数组类型;支付卡网络
  16. 'AMEX','DISCOVER','INTERAC','JCB','MASTERCARD','VISA'
  17. ]
  18. },
  19. },
  20. ]
  21. }

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:, //布尔类型;是否能使用 Google Pay API 进行付款
  3. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. msg:, //字符串类型;错误信息
  3. }

示例代码

  1. var googlePay = api.require('googlePay');
  2. googlePay.isReadyToPay({
  3. request:{},
  4. }, function(ret, err) {
  5. alert(JSON.stringify(ret));
  6. });

可用性

Android系统

可提供的1.0.0及更高版本

requestPayment

请求付款

requestPayment({params},callback(ret))

params

paymentData:

  1. {
  2. allowedPaymentMethods:[
  3. {
  4. tokenizationSpecification:{ //Json对象类型;配置要接收可扣款付款信息的帐号
  5. type:'PAYMENT_GATEWAY', //字符串类型;付款方式
  6. parameters:{ //Json对象类型;令牌化类型所特有的参数
  7. gateway:'example',
  8. gatewayMerchantId:'exampleGateway' //字符串类型;MerchantId
  9. }
  10. }
  11. },
  12. ],
  13. transactionInfo:{ //Json对象类型;交易授权的详细信息
  14. totalPrice:'', //字符串类型;价格
  15. totalPriceLabel:'', //字符串类型;总价的自定义标签
  16. checkoutOption:'', //字符串类型;提交按钮文本
  17. currencyCode:'', //字符串类型;ISO 4217 字母货币代码
  18. totalPriceStatus:'', //字符串类型;总价状态
  19. },
  20. merchantInfo:{ //Json对象类型;商家信息
  21. merchantId:'', //字符串类型;商家id
  22. merchantName:'', //字符串类型;商家名称
  23. merchantOrigin:'', //字符串类型;商家完全限定域名
  24. },
  25. shippingAddressRequired:true,
  26. shippingAddressParameters:{ //Json对象类型;送货限制
  27. allowedCountryCodes:[], //Json数组类型;允许送货的国家/地区的 ISO 3166-1 alpha-2 国家/地区代码值
  28. phoneNumberRequired:, //布尔类型;是否需要填写电话号码
  29. }
  30. }

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:, //布尔类型;是否可付款
  3. paymentInfo:{}, //Json对象类型;可获取支付方式,支付token,收款人等信息。
  4. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {errCode:, //数字类型;错误码
  2. msg:, //字符串类型;错误信息
  3. }

示例代码

  1. var googlePay = api.require('googlePay');
  2. googlePay.requestPayment({
  3. paymentData:{},
  4. }, function(ret, err) {
  5. alert(JSON.stringify(ret));
  6. });

可用性

Android系统

可提供的1.0.0及更高版本