更新记录

1.0.3(2026-03-28) 下载此版本

iOS的微信sdk升级至最新的2.0.5

1.0.2(2025-02-26) 下载此版本

按照规范修改options参数类型(RequestMerchantTransferOption 更改为RequestMerchantTransferOptions)

1.0.1(2025-02-25) 下载此版本

更新接口兼容性描述

查看更多

平台兼容性

uni-app(4.61)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS iOS插件版本 鸿蒙
- - - - - - - 12 1.0.3 -
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
- - - - - - - - - - - -

uni-app x(4.61)

Chrome Safari Android iOS 鸿蒙 微信小程序
- - - - - -

uni-requestMerchantTransfer

实现打开微信请求用户确认收款功能。
API规范文档

uni-requestMerchantTransfer

微信小程序平台参考:微信小程序API规范

uni.requestMerchantTransfer(options: RequestMerchantTransferOption)

商家转账用户确认模式下,在移动端应用APP中集成开放SDK调起微信请求用户确认收款。

RequestMerchantTransferOption参数:

名称 类型 必备 描述
mchId string 商户号
subMchId string 子商户号,服务商模式下必填
package string 商家转账付款单跳转收款页 pkg 信息,商家转账付款单受理成功时返回给商户
appId string 商户 appId(微信平台appid),普通模式下必填,服务商模式下,appId 和 subAppId 二选一填写
subAppId string 子商户 appId(微信平台子appid),服务商模式下,appId 和 subAppId 二选一填写
openId string 收款用户 openId, 对应传入的商户 appId 下,某用户的 openId
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

示例:

uni.requestMerchantTransfer({
    "mchId": "mchId",
    "appId": "微信开发者平台对应app的APPID",
    "package": "package",
    success: (res) => {
        console.log(res)
    },
    fail: (res) => {
        console.log(res.errMsg)
    },
    complete: (res) => {
        console.log(res.errMsg)
    }
})

注意事项

iOS平台必须在项目根目录下的 Info.plist 文件中配置微信开发者平台的APPID和通用链接,配置后需提交云端打包生效。

  1. WeChat 节点下配置 appiduniversalLink
  2. CFBundleURLTypes 节点下配置 scheme 数据

示例如下:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
    <dict>
        <key>WeChat</key>
        <dict>
            <key>appid</key>
            <string>请填写微信开发者平台对应app的APPID</string>
            <key>universalLink</key>
            <string>请填写能唤起当前应用的Universal Links路径</string>
        </dict>

        <key>CFBundleURLTypes</key>
        <array>
            <dict>
                <key>CFBundleTypeRole</key>
                <string>Editor</string>
                <key>CFBundleURLName</key>
                <string>WeChat</string>
                <key>CFBundleURLSchemes</key>
                <array>
                    <string>请填写微信开发者平台对应app的APPID</string>
                </array>
            </dict>
        </array>
    </dict>
</plist>

如果同时使用了微信支付、微信登录、微信分享模块时,appid 和 universalLink 的值需与 manifest.json 中配置的值保持一致。

uts 语言介绍

uts,全称 uni type script,是一门跨平台的、高性能的、强类型的现代编程语言。

它可以被编译为不同平台的编程语言,如:

Android平台:编译为Kotlin
iOS平台:编译Swift
鸿蒙OS平台:编译为ArkTS
web平台/小程序:编译为JavaScript

uts 采用了与 ts 基本一致的语法规范,支持绝大部分 ES6 API。

但为了跨端,uts进行了一些约束和特定平台的增补。

过去在js引擎下运行支持的语法,大部分在uts的处理下也可以平滑的在kotlin和swift中使用。但有一些无法抹平,需要使用条件编译。

和uni-app的条件编译类似,uts也支持条件编译。写在条件编译里的,可以调用平台特有的扩展语法。

uts 插件介绍

UTS 插件是一种特定的 uni_modules 插件,其核心目的是允许 uni-app/uni-app x 开发者使用 UTS 语法来调用扩展 API(封装原生系统的API或三方SDK)。

UTS 插件的实现代码主要位于 utssdk 目录下,并按平台进行分离和组织: 目录/文件 目标平台 实现语言 作用描述
utssdk/app-android Android UTS, Kotlin, Java 存放 UTS 插件在 Android 平台上的具体实现源码
utssdk/app-ios iOS UTS, Swift 存放 UTS 插件在 iOS 平台上的具体实现源码
utssdk/app-harmony HarmonyOS (鸿蒙) UTS, ArkTS 存放 UTS 插件在 HarmonyOS 平台上的具体实现源码
utssdk/*.uts 多平台共用 UTS 存放使用 UTS 语言编写的、可供 所有平台 共用的实现源码

参考文档

隐私、权限声明

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

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

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

许可协议

MIT协议