更新记录

1.0.7（2026-04-13）

• 修复android微信支付没有回调

1.0.6（2025-06-28）

• 更新iOS sdk版本20241008

1.0.5（2024-08-05）

• 升级mpay sdk
• 修复ios openURL

平台兼容性

原生插件通用使用流程：

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原生插件配置”->”云端插件“列表中删除该插件重新选择

使用文档 （更多插件及问题，请加vx：zhuzheVIP1）

超级福利

说明

此插件提供 澳门通移动支付（mpay） 功能

配置说明

android

如果只用到mpay支付，则忽略以下说明。

• 不可使用uniapp自带wechat支付，回调会冲突
• 如果未使用uniapp自带支付宝支付，可以配置sn-mpay-fix开启支付宝支付

如果用到wechat支付，需要下载uts辅助插件 sn-mpay-fix

uni_modules
└── sn-mpay-fix
    └── utssdk
        ├── app-android
        │   ├── AndroidManifest.xml
        │   ├── config.json
        │   └── src
        │       ├── Hybrid.kt
        │       └── index.kt
        └── app-ios
            ├── config.json
            └── src
                ├── Hybrid.swift
                └── index.swift

支付宝支付： 修改sn-mpay-fix/utssdk/app-android/config.json

{
  "minSdkVersion": "21",
  "dependencies": [
    "com.tencent.mm.opensdk:wechat-sdk-android-without-mta:6.8.0",
    "com.alipay.sdk:alipaysdk-android:15.8.11"
  ]
}

修改App.vue，导入uts插件(必须导入后，才能云打包)

<script>
    import * as MpayFix from '@/uni_modules/sn-mpay-fix'
    export default {
        onLaunch: function() {
            console.log('App Launch')
        },
        onShow: function() {
            console.log('App Show')
        },
        onHide: function() {
            console.log('App Hide')
        }
    }
</script>

<style>
    /*每个页面公共css */
</style>

ios

• ios必须使用uniapp自带wechat支付和支付宝支付

• scheme 配置

manifest.json -> 源码视图，配置如下，关键是ios->urltypes的配置

"distribute": {
    ...
    "ios": {
        "urltypes": [{
            "urlidentifier": "merchants",
            "urlschemes": ["macaupayF20982"]
        }]
    },
    ...
}

其中，macaupayF20982 需要替换成自己的scheme，这个非常重要

接口文档

• setAlipayEnv - 开启alipay沙盒

  0 - online

  1 - sandbox

• setEnvironmentType - 设置环境类型

  生產： setEnvironmentType(0)

  SIT: setEnvironmentType(1)

  UAT： setEnvironmentType(2)

• setMPayAppId - 设置

  仅android支持

  如果是UAT 环境的需要设置setMPayAppId(2)，如果要切換到生產環境請把setMPayAppId(2) 去掉

• initWeChatData - 初始化wechat配置

• newPayAll - 发起支付（android）

• mpay - mpay支付（iOS）

• alipay - alipay支付（iOS）

• wechat - wechat支付（iOS）

代码示例

const mpay = uni.requireNativePlugin("sn-mpay");

// 仅android，开启支付宝沙盒，生产环境请勿调用
mpay.setAlipayEnv(1);

mpay.setEnvironmentType(0);

// initWeChatData
var systemInfo = uni.getSystemInfoSync();
if (systemInfo.platform == "android") {
  // android
  mpay.initWeChatData("wx739792343");
} else if (systemInfo.platform == "ios") {
  // ios
  mpay.initWeChatData({
    appId: "wx739792343",
    universalLink: "",
  });
}

//android，第一个参数是支付参数（从服务器获取支付参数，json字符串）
mpay.newPayAll("{}", (e) => {
  // e.type = openSdk | mpay | alipay | wechat
  // e.data = { resultStatus: '', result: '', memo:''}
});

// ios

mpay.mpay({
  payJson: "{}", // 从服务器获取支付参数，json字符串
  scheme: "",
}, (e) => {
  // e.code = 0:成功 | 1:失败
  // e.order = {} // 当e.code = 0返回订单结果
  // 当失败的时候，打印e可以看到具体错误信息
});

mpay.alipay({
  payJson: "{}", // 从服务器获取支付参数，json字符串
  scheme: "",
}, (e) => {
  // e.code = 0:成功 | 1:失败
  // e.order = {} // 当e.code = 0返回订单结果
  // 当失败的时候，打印e可以看到具体错误信息
});

mpay.wechat({
  payJson: "{}", // 从服务器获取支付参数，json字符串
  scheme: "",
}, (e) => {
  // e.code = 0:成功 | 1:失败
  // e.order = {} // 当e.code = 0返回订单结果
  // 当失败的时候，打印e可以看到具体错误信息
});