更新记录

1.0.1（2023-11-08）

第一版

平台兼容性

原生插件通用使用流程：

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 v5 支付功能

使用前提

• 支付接入流程请参考

• 支付前请确保配置好您的商品，官方文档

• 支付流程参考 官方文档

• 交易归因参考 官方文档

• 内购测试流程

• 内侧流程参考

注意

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

方法

• init

  初始化

• querySku

  查询 sku

• pay

  发起支付

• payAll

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

• consume

  消耗品 确认交易

• acknowledge

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

• queryPurchases

  查询当前购买记录

• queryPurchaseHistory

  查询历史购买记录

使用

var googlePay = uni.requireNativePlugin("sn-googlepay5");
// 初始化
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的结果
googlePay.pay({
  productId: "", // 产品id
  offerToken: "", // 折扣token，可选参数
  // 以下参数用于更新订阅, 参数参考 https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.SubscriptionUpdateParams.Builder
  oldPurchaseToken: "", //
  replacementMode: 0, //
  prorationMode: 0, //
  externalTransactionId: "", //
}, (e) => {
  if (e.code == 0) {
    // 支付成功
    e.data; //支付结果, array [ {original:{ }, signature: ''} ]
  } else {
    // 支付失败
  }
});

// 发起支付（支持更多参数）
googlePay.payAll(
  {
    productId: "", // 产品id
    offerToken: "", // 折扣token，可选参数
    accountId: "", // 用户Id，可选参数
    profileId: "", // 个人资料Id，可选参数
    // 以下参数用于更新订阅，参数参考 https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.SubscriptionUpdateParams.Builder
    oldPurchaseToken: "", //
    replacementMode: 0, //
    prorationMode: 0, //
    externalTransactionId: "", //
  },
  (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; // 采购结果, {code:0,msg:''}
      e.purchasesList; // 采购列表,不一定有 [ {original:{ }, signature: ''} ]
    } else {
      // 查询失败
    }
  },
);

// 查询历史购买记录
googlePay.queryPurchaseHistory(
  {
    skuType: "inapp", // inapp 或 subs
  },
  (e) => {
    if (e.code == 0) {
      // 查询成功
      e.billingResult; // 采购结果, {code:0,msg:''}
      e.purchasesList; // 采购列表,不一定有 [ {original:{ }, signature: ''} ]
    } 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 版本是否太低，升级试试

• 无法购买

  请参考以下文章排查

  • https://www.zhihu.com/question/35295183
  • https://www.bilibili.com/read/cv6837855