更新记录

1.0.3(2021-09-22)

  • 升级 SDK 4.0.0

1.0.2(2021-05-24)

  • 升级SDK 3.0.3
  • 增加payAll接口,支持购买交易归因
查看更多

平台兼容性

Android iOS
适用版本区间:5.0 - 11.0 ×

原生插件通用使用流程:

  1. 购买插件,选择该插件绑定的项目。
  2. 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
  3. 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
  4. 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
  5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择


使用文档 (更多插件及问题,请加微信:zhuzheVIP1)

超级福利

说明

此插件提供 android google 支付功能

使用前提

注意

切记不要用国内 google 账号,国内账号已经不能支付

方法

  • init

    初始化

  • querySku

    查询 sku

  • pay

    发起支付

  • payAll

    发起支付,可以支持更多参数。比如设置交易归因

  • consume

    消耗品 确认交易

  • acknowledge

    非消耗品、订阅型 确认交易

  • queryPurchases

    查询当前购买记录

使用

var googlePay = uni.requireNativePlugin("sn-googlepay");
// 初始化
googlePay.init({}, (e) => {
  if (e.code == 0) {
    // 初始化成功
  } else {
    // 初始化失败
  }
});

// 查询sku
googlePay.querySku(
  {
    inapp: ["inapp_test", "inapp_test1"], // 与subs二选一, 参数为商品ID(字符串)数组
    subs: ["sub_test", "sub_test1"], // 与inapp二选一,参数为商品ID(字符串)数组
  },
  (e) => {
    if (e.code == 0) {
      // 查询成功
      e.list; // 查询结果, array
    } else {
      // 查询失败
    }
  }
);

// 发起支付, 支付参数来自查询sku的结果中的一项,即querySku返回的list的某一项
googlePay.pay(list[0], (e) => {
  if (e.code == 0) {
    // 支付成功
    e.data; //支付结果, array [ {original:{ }, signature: ''} ]
  } else {
    // 支付失败
  }
});

// 发起支付(支持更多参数)
googlePay.payAll(
  {
    sku: list[0], // 来自查询sku的结果中的一项,即querySku返回的list的某一项
    accountId: "", // 可选参数
    profileId: "", // 可选参数
  },
  (e) => {
    if (e.code == 0) {
      // 支付成功
      e.data; //支付结果, array [ {original:{ }, signature: ''} ]
    } else {
      // 支付失败
    }
  }
);

// 确认交易 - 消耗型商品
googlePay.consume(
  {
    purchaseToken: "aa", // 来自支付结果的original.purchaseToken (或 original.token)
  },
  (e) => {
    if (e.code == 0) {
      // 确认成功
    } else {
      // 确认失败
    }
  }
);
// 确认交易 - 非消耗型商品 或 订阅型
googlePay.acknowledge(
  {
    original: {}, // 来自支付结果
    signature: "",
  },
  (e) => {
    if (e.code == 0) {
      // 确认成功
    } else {
      // 确认失败
    }
  }
);

// 查询采购记录
googlePay.queryPurchases(
  {
    skuType: "inapp", // inapp 或 subs
  },
  (e) => {
    if (e.code == 0) {
      // 查询成功
      e.billingResult; // 采购结果
      e.purchasesList; // 采购列表
    } else {
      // 查询失败
    }
  }
);

常见错误

  • Google Play In-app Billing API version is less than 3

    主要原因:

    • google play 版本过低,需要升级
    • google play 登陆过国内账号,需要清除缓存 ,参考https://www.jianshu.com/p/85d5dd523cb7
  • 常见错误 code

    BillingResponseCode

  • Invalid SKU details

    {
    "code": 5,
    "msg": "Invalid SKU details."
    }

    如果报这个错,请检查 2 点:1、必须国外 google 账号测试 2、google play 版本是否太低,升级试试

  • 无法购买

    请参考以下文章排查

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问