tmui-cli 2.0.3 → 2.0.5

package/data/uniappx/api/request-merchant-transfer.md

@@ -0,0 +1,117 @@
+::: sourceCode
+## uni.requestMerchantTransfer(options) @requestmerchanttransfer
+
+> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-requestMerchantTransfer
+
+> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-requestMerchantTransfer
+
+商家转账用户确认模式下，拉起页面请求用户确认收款
+
+::: info
+uni.requestMerchantTransfer 是​商家转账到用户零钱的API，适用于需要向用户直接发放资金（如提现、奖励发放、活动返现）的场景。
+
+注意：
+  - [APP调起用户确认收款] 和 [APP调起用户免确认收款授权] 是用一个 API，参数一致
+  - 开发者需在[微信支付商户平台/合作伙伴平台-产品中心](https://pay.weixin.qq.com/)，申请开通商家转账
+  - 具体流程请参考[微信商家转账文档](https://pay.weixin.qq.com/doc/v3/merchant/4012711988)
+  - app-ios 需要在可视化界面配置scheme、universalLink 参数，详见 [iOS配置/uni-payment(支付)/微信支付](https://doc.dcloud.net.cn/uni-app-x/collocation/manifest-ios.html#paymentweixin)
+  - 该功能支持 uniapp 项目，请使用插件[uni-requestMerchantTransfer](https://ext.dcloud.net.cn/plugin?id=22283)
+  - uniapp x 的iOS端和安卓端已内置此插件，但鸿蒙端需要下载插件[uni-requestMerchantTransfer](https://ext.dcloud.net.cn/plugin?id=22283)
+
+### requestMerchantTransfer 兼容性  
+| Web | 微信小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- |
+| <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.41 | 4.61 | 4.61 | 5.22 |
+
+### 参数 
+
+| 名称 | 类型 | 必填 | 兼容性 |
+| :- | :- | :- |  :-: |
+| options | **RequestMerchantTransferOptions** | 是 | Web x（部分支持，见上） |
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| mchId | string | 是 | Web x / 微信小程序 4.61 / Android 4.61 / iOS 4.61 / HarmonyOS 5.22（部分支持，见上） | 商户号 |
+| package | string | 是 | Web x / 微信小程序 4.61 / Android 4.61 / iOS 4.61 / HarmonyOS 5.22（部分支持，见上） | 商家转账付款单跳转收款页 pkg 信息,商家转账付款单受理成功时返回给商户 |
+| appId | string | 否 | Web x / 微信小程序 4.61 / Android 4.61 / iOS 4.61 / HarmonyOS 5.22（部分支持，见上） | 商户 appId（微信平台appid），普通模式下必填，服务商模式下，appId 和 subAppId 二选一填写 |
+| openId | string | 否 | Web x / 微信小程序 4.61 / Android 4.61 / iOS 4.61 / HarmonyOS x（部分支持，见上） | 收款用户 openId， 对应传入的商户 appId 下，某用户的 openId |
+| subAppId | string | 否 | Web x / 微信小程序 4.61 / Android 4.61 / iOS 4.61 / HarmonyOS x（部分支持，见上） | 子商户 appId（微信平台子appid)，服务商模式下，appId 和 subAppId 二选一填写 |
+| subMchId | string | 否 | Web x / 微信小程序 4.61 / Android 4.61 / iOS 4.61 / HarmonyOS x（部分支持，见上） | 子商户号，服务商模式下必填 |
+| success | (res: [RequestMerchantTransferGeneralCallbackResult](#requestmerchanttransfergeneralcallbackresult-values)) => void | 否 | Web x / 微信小程序 4.61 / Android 4.61 / iOS 4.61 / HarmonyOS 5.22（部分支持，见上） | 接口调用成功的回调函数 |
+| fail | (res: [RequestMerchantTransferGeneralCallbackResult](#requestmerchanttransfergeneralcallbackresult-values)) => void | 否 | Web x / 微信小程序 4.61 / Android 4.61 / iOS 4.61 / HarmonyOS 5.22（部分支持，见上） | 接口调用失败的回调函数 |
+| complete | (res: [RequestMerchantTransferGeneralCallbackResult](#requestmerchanttransfergeneralcallbackresult-values)) => void | 否 | Web x / 微信小程序 4.61 / Android 4.61 / iOS 4.61 / HarmonyOS 5.22（部分支持，见上） | 接口调用结束的回调函数（调用成功、失败都会执行） | 
+
+#### RequestMerchantTransferGeneralCallbackResult 的属性值 @requestmerchanttransfergeneralcallbackresult-values 
+
+| 名称 | 类型 | 必备 | 兼容性 |
+| :- | :- | :- |  :-: |
+| errMsg | string | 是 | Web x（部分支持，见上） |
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.payment.requestMerchantTransfer)
+- [参见uni-app相关文档](https://uniapp.dcloud.net.cn/api/plugins/request-merchant-transfer.html)
+- [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/payment/wx.requestMerchantTransfer.html)
+- [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=requestMerchantTransfer&pageIndex=1&pageSize=10&source=doc_top&type=all)
+- [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=requestMerchantTransfer&scope=devdocs&source=docs)
+- [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=requestMerchantTransfer&secondType=all&type=1)
+- [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=requestMerchantTransfer&topicFilter=)
+- [钉钉小程序文档](https://open.dingtalk.com/search?keyword=requestMerchantTransfer)
+- [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
+- [快手小程序文档](https://developers.kuaishou.com/page?keyword=requestMerchantTransfer&from=docs)
+- [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
+- [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
+- [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
+
+### 示例
+
+示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/API/request-merchant-transfer/request-merchant-transfer.uvue)，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/API/request-merchant-transfer/request-merchant-transfer.uvue) 
+>
+> 该 API 不支持 Web，请运行 hello uni-app x 到 App 平台体验 
+
+::: preview
+> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/API/request-merchant-transfer/request-merchant-transfer
+```uvue
+<template>
+  <view class="content">
+    <button class="button" @click="pay">支付0.2元</button>
+    <button class="button" @click="transfer" :disabled="disabled">接受0.1元转账</button>
+    <text class="tips" v-if="disabled" style="color: #ff5a5f;">请先支付 0.2 元，才能体验接收转账 0.1 元</text>
+    
+    <view v-else><text class="tips" style="color: #42b983;">若已支付 0.2 元，请点击“接受0.1元转账”按钮</text></view>
+    
+
+    
+    <view v-else><text class="tips" style="color: #42b983;">已支付 0.2 元，请点击“接受0.1元转账”按钮</text></view>
+    
+  </view>
+</template>
+
+<style>
+  .content {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    padding: 20px;
+  }
+
+  .button {
+    width: 100%;
+    margin-bottom: 20px;
+    border-radius: 5px;
+  }
+
+  .tips {
+    color: #999;
+    font-size: 14px;
+  }
+</style>
+
+```
+
+## 通用类型
+
+### GeneralCallbackResult @generalcallbackresult-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errMsg | string | 是 | 错误信息 |

package/data/uniappx/api/request-payment.md

@@ -0,0 +1,315 @@
+::: sourceCode
+## uni.requestPayment(options) @requestpayment
+
+> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-payment
+
+> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-payment
+
+请求支付
+
+### requestPayment 兼容性  
+| Web | 微信小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- |
+| <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.41 | 4.02 | 4.18 | 4.61 |
+
+uni.requestPayment是一个统一各平台的客户端支付API，客户端均使用本API调用支付。
+
+本API运行在各端时，会自动转换为各端的原生支付调用API。
+
+注意支付不仅仅需要客户端的开发，还需要服务端开发。虽然客户端API统一了，但各平台的支付申请开通、配置回填仍然需要看各个平台本身的支付文档。
+
+比如微信有App支付的申请入口和使用流程，对应到uni-app，在App端要申请微信的App支付。
+
+如果服务端使用[uniCloud](https://uniapp.dcloud.io/uniCloud/README)，那么官方提供了[uniPay](https://doc.dcloud.net.cn/uniCloud/uni-pay/uni-app.html)云端统一支付服务，把App、微信小程序、支付宝小程序里的服务端支付开发进行了统一的封装。
+
+前端统一的`uni.requestPayment`和云端统一的`uniPay`搭配，可以极大提升支付业务的开发效率，强烈推荐给开发者使用。`uniPay`的文档另见：[https://doc.dcloud.net.cn/uniCloud/uni-pay/uni-app.html](https://doc.dcloud.net.cn/uniCloud/uni-pay/uni-app.html)
+
+### 参数 
+
+| 名称 | 类型 | 必填 | 兼容性 |
+| :- | :- | :- |  :-: |
+| options | **RequestPaymentOptions** | 是 | Web x（部分支持，见上） |
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| provider | string | 是 | Web x / Android 4.02 / iOS 4.18 / HarmonyOS 4.61（部分支持，见上） | 支付服务提供商，通过 [uni.getProvider](https://doc.dcloud.net.cn/uni-app-x/api/provider.html) 获取,目前支持支付宝支付(alipay),微信支付(wxpay) |
+| orderInfo | string | 是 | Web x / 微信小程序 x / Android 4.02 / iOS 4.18 / HarmonyOS 4.61（部分支持，见上） | 订单数据 |
+| success | (result: [RequestPaymentSuccess](#requestpaymentsuccess-values)) => void | 否 | Web x / 微信小程序 4.41 / Android 4.02 / iOS 4.18 / HarmonyOS 4.61（部分支持，见上） | 接口调用成功的回调函数 |
+| fail | (result: [RequestPaymentFail](#requestpaymentfail-values)) => void | 否 | Web x / 微信小程序 4.41 / Android 4.02 / iOS 4.18 / HarmonyOS 4.61（部分支持，见上） | 接口调用失败的回调函数 |
+| complete | (result: any) => void | 否 | Web x / 微信小程序 4.41 / Android 4.02 / iOS 4.18 / HarmonyOS 4.61（部分支持，见上） | 接口调用结束的回调函数（调用成功、失败都会执行） |
+| nonceStr | string | 否 | Web x / 微信小程序 4.41（部分支持，见上） | 随机字符串，长度为32个字符以下<br/> |
+| package | string | 否 | Web x / 微信小程序 4.41（部分支持，见上） | 统一下单接口返回的 prepay_id 参数值，提交格式如：prepay_id=***<br/> |
+| paySign | string | 否 | Web x / 微信小程序 4.41（部分支持，见上） | 签名，具体见微信支付文档<br/> |
+| timeStamp | string | 否 | Web x / 微信小程序 4.41（部分支持，见上） | 时间戳，从 1970 年 1 月 1 日 00:00:00 至今的秒数，即当前的时间<br/> |
+| signType | string | 否 | Web x / 微信小程序 4.41（部分支持，见上） | 签名算法，应与后台下单时的值一致<br/><br/>可选值：<br/>- 'MD5': 仅在 v2 版本接口适用;<br/>- 'HMAC-SHA256': 仅在 v2 版本接口适用;<br/>- 'RSA': 仅在 v3 版本接口适用;<br/> |
+@@| 合法值 | 兼容性 |
+@@| :- |  :-: |
+@@| MD5 | Web x（部分支持，见上） |
+@@| HMAC-SHA256 | Web x（部分支持，见上） |
+@@| RSA | Web x（部分支持，见上） | 
+
+#### RequestPaymentSuccess 的属性值 @requestpaymentsuccess-values 
+
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| data | object | 否 | Web x / 微信小程序 4.41 / Android 4.02 / iOS 4.18 / HarmonyOS 4.61（部分支持，见上） | 返回数据 |
+
+#### RequestPaymentFail 的属性值 @requestpaymentfail-values 
+
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| errCode | number | 是 | Web x（部分支持，见上） | 错误码 |
+| 合法值 | 兼容性 | 描述 |
+| :- |  :-: | :- |
+| 700600 | Web x / Android 4.02 / iOS 4.18 / HarmonyOS 4.61（部分支持，见上） | 正在处理中，支付结果未知（有可能已经支付成功），请查询商家订单列表中订单的支付状态 |
+| 701100 | Web x / Android 4.02 / iOS 4.18 / HarmonyOS 4.61（部分支持，见上） | 订单支付失败。 |
+| 701110 | Web x / Android 4.02 / iOS 4.18 / HarmonyOS 4.61（部分支持，见上） | 重复请求。 |
+| 700601 | Web x / Android 4.02 / iOS 4.18 / HarmonyOS 4.61（部分支持，见上） | 用户中途取消。 |
+| 700602 | Web x / Android 4.02 / iOS 4.18 / HarmonyOS 4.61（部分支持，见上） | 网络连接出错。 |
+| 700603 | Web x / Android 4.02 / iOS 4.18 / HarmonyOS 4.61（部分支持，见上） | 支付结果未知（有可能已经支付成功），请查询商家订单列表中订单的支付状态。 |
+| 700000 | Web x / Android 4.02 / iOS 4.18 / HarmonyOS 4.61（部分支持，见上） | 其它支付错误。 |
+| 700604 | Web x / Android 4.02 / iOS 4.18 / HarmonyOS 4.61（部分支持，见上） | 微信没有安装。 |
+| 700605 | Web x / Android 4.02 / iOS 4.18 / HarmonyOS 4.61（部分支持，见上） | 服务供应商获取失败。 |
+| 700607 | Web x / Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 支付未完成。 |
+| 700608 | Web x / Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 服务商返回参数错误。 |
+| 700800 | Web x / Android x / iOS 4.18 / HarmonyOS x（部分支持，见上） | 没有配置对应的URL Scheme。 |
+| 700801 | Web x / Android x / iOS 4.18 / HarmonyOS x（部分支持，见上） | 没有配置对应的Universal Link。 |
+| errSubject | string | 是 | Web x（部分支持，见上） | 统一错误主题（模块）名称 |
+| data | any | 否 | Web x（部分支持，见上） | 错误信息中包含的数据 |
+| cause | Error | 否 |   | 源错误信息，可以包含多个错误，详见SourceError |
+| errMsg | string | 是 | Web x（部分支持，见上） |  |
+
+### orderInfo参数说明
+
+ - 支付宝支付
+  App 支付请求参数字符串，主要包含商家的订单信息，key=value 形式，以 & 连接。示例
+  ```
+  app_id=2015052600090779&biz_content=%7B%22timeout_express%22%3A%2230m%22%2C%22seller_id%22%3A%22%22%2C%22product_code%
+  22%3A%22QUICK_MSECURITY_PAY%22%2C%22total_amount%22%3A%220.02%22%2C%22subject%22%3A%221%22%2C%22body%22%3A%22%E6%88%
+  91%E6%98%AF%E6%B5%8B%E8%AF%95%E6%95%B0%E6%8D%AE%22
+  %2C%22out_trade_no%22%3A%22314VYGIAGG7ZOYY%22%7D&charset=utf-8&method=alipay.trade.app.pay&sign_type=R
+  SA2&timestamp=2016-08-15%2012%3A12%3A15&version=1.0&sign=MsbylYkCzlfYLy9PeRwUUIg9nZPeN9SfXPNavUCroGKR5Kqvx0nEnd3eRmKxJuthNUx4ERCXe552
+  EV9PfwexqW%2B1wbKOdYtDIb4%2B7PL3Pc94RZL0zKaWcaY3tSL89%2FuAVUsQuFqEJd
+  hIukuKygrXucvejOUgTCfoUdwTi7z%2BZzQ%3D<br>
+  ```
+  [更多详情参考[支付宝官方文档](https://opendocs.alipay.com/open/204/105296?pathHash=22ed0058&ref=api)]
+
+ -  微信支付
+  App 支付请求参数字符串,需要打自定义基座。示例
+  ```json
+  {
+   "appid":"wxd569c7238830733b",
+   "noncestr":"6N47VnR42bqIm4xq",
+   "package":"Sign=WXPay",
+   "partnerid":"1230636401",
+   "prepayid":"wx26174750316675ac54b89c224eb3250000",
+   "timestamp":1711446470,
+   "sign":"EE987459B9CFF6462462147130110D31"
+  }
+  ```
+  [更多详情参考[微信官方文档]( https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=9_1)]
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.payment.requestPayment)
+- [参见uni-app相关文档](https://uniapp.dcloud.net.cn/api/plugins/payment.html#requestpayment)
+- [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/payment/wx.requestPayment.html)
+- [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=requestPayment&pageIndex=1&pageSize=10&source=doc_top&type=all)
+- [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=requestPayment&scope=devdocs&source=docs)
+- [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=requestPayment&secondType=all&type=1)
+- [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=requestPayment&topicFilter=)
+- [钉钉小程序文档](https://open.dingtalk.com/search?keyword=requestPayment)
+- [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
+- [快手小程序文档](https://developers.kuaishou.com/page?keyword=requestPayment&from=docs)
+- [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
+- [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
+- [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
+
+### 支付provider对象描述 @providerdes
+
+UniPaymentAlipayProvider(支付宝支付)继承自 [UniProvider](./provider.md#uniprovider)
+
+UniPaymentWxpayProvider(微信支付)继承自 [UniProvider](./provider.md#uniprovider)，特有字段说明：
+
+| 名称           | 类型      | 必备 | 默认值  | 描述                                  |
+| -------------- | --------- | ---- | ------ | ------------------------------------- |
+| isWeChatInstalled     | boolean   | 是    | -      | 判断微信是否安装 |
+
+### 支付SDK错误码
+
+支付失败时可通过错误回调参数`IRequestPaymentFail`中的`cause`属性获取支付SDK的源错误信息，类型为[SourceError](https://uniapp.dcloud.net.cn/tutorial/err-spec.html#sourceerror)，其包含 code 属性存储了支付SDK的原始错误码。
+
+#### 支付宝支付
+| 支付宝错误码 | 错误信息 |
+|---|---|
+| 9000 | 订单支付成功 |
+| 8000 | 正在处理中，支付结果未知（有可能已经支付成功），请查询商家订单列表中订单的支付状态 |
+| 4000 | 订单支付失败 |
+| 5000 | 重复请求 |
+| 6001 | 用户中途取消 |
+| 6002 | 网络连接出错 |
+| 6004 | 支付结果未知（有可能已经支付成功），请查询商家订单列表中订单的支付状态 |
+|  其它  | 其它支付错误 |
+
+#### 微信支付
+
+| 微信支付错误码 | 错误信息 |
+|---|---|
+| 0 | 成功 |
+| -1 | 可能的原因：签名错误、未注册APPID、项目设置APPID不正确、注册的APPID与设置的不匹配、其他异常原因等 |
+| -2 | 无需处理。发生场景：用户不支付了，点击取消，返回APP |
+| -3 | 发送失败 |
+| -4 | 授权被拒绝 |
+| -5 | 不支持 |
+| -6 | 禁止 |
+| 其它 | 其它支付错误 |
+
+### 注意
+- App平台开发支付宝支付，无需自定义基座，真机运行可直接开发
+- App平台判断微信是否安装可以通过`uni.getProvider`的方式，详见[uni.getProvider](https://doc.dcloud.net.cn/uni-app-x/api/provider.html#getprovider)
+- 在4.25版本前使用微信支付，Android需要在隐私协议弹框后调用微信sdk
+
+```ts
+   uni.getProvider({
+      service: "payment",
+      success: (e) => {
+         const provider = e.providers.find((item): boolean => {
+            return item.id == 'wxpay'
+         })
+
+          // #ifdef APP-ANDROID
+          if (provider != null && provider instanceof UniPaymentWxpayProvider && !((provider as UniPaymentWxpayProvider).isWeChatInstalled)) {
+            console.log('WeChat 没有安装')
+          } else {
+             console.log('WeChat 已安装')
+          }
+          // #endif
+          // #ifdef APP-IOS
+          if (provider != null && ((provider as UniPaymentWxpayProvider).isWeChatInstalled == undefined || ((provider as UniPaymentWxpayProvider).isWeChatInstalled != null && (provider as UniPaymentWxpayProvider).isWeChatInstalled == false))) {
+            console.log('WeChat 没有安装')
+          } else {
+            console.log('WeChat 已安装')
+          }
+          // #endif
+      },
+      fail: (e) => {
+         console.log("获取支付通道失败：", e);
+      }
+   })
+```
+
+- **app需要在根目录manifest.json文件中配置`uni-payment`节点，详见 [https://doc.dcloud.net.cn/uni-app-x/collocation/manifest-modules.html#uni-payment模块配置](https://doc.dcloud.net.cn/uni-app-x/collocation/manifest-modules.html#uni-payment)**
+- app 在`HBuilderX 4.71+`支持可视化界面配置，各平台配置请参考：
+  [app-ios平台](https://doc.dcloud.net.cn/uni-app-x/collocation/manifest-ios.html#modulespayment)、
+  [app-android平台](https://doc.dcloud.net.cn/uni-app-x/collocation/manifest-android.html#modulespayment)、
+  [app-harmony平台](https://doc.dcloud.net.cn/uni-app-x/collocation/manifest-harmony.html#modulespayment)
+- app-android平台微信支付需要4.11及以上版本
+- app-ios平台微信支付需要4.18及以上版本
+- 关于支付宝支付，当传入orderinfo参数后，app-android平台可以成功调用支付宝，但app-ios平台有时会出现奔溃&卡顿，这时候需要检测后端 ‘out_trade_no’ 参数是否设置为string类型，参考[支付宝文档：业务请求参数](https://opendocs.alipay.com/open/cd12c885_alipay.trade.app.pay)
+
+### 示例
+
+示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/API/request-payment/request-payment.uvue)，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/API/request-payment/request-payment.uvue) 
+>
+> 该 API 不支持 Web，请运行 hello uni-app x 到 App 平台体验 
+
+::: preview
+> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/API/request-payment/request-payment
+```uvue
+<template>
+  <page-head title="发起支付"></page-head>
+  <view class="uni-common-mt payment-content">
+    <text>如对当前页面的支付示例功能有任何疑问，通过电子邮件：service@dcloud.io 联系我们</text>
+  </view>
+  <view class="payment-content">
+    <template v-if="providerList.length > 0">
+      <button class="payment-button" type="primary" v-for="(item, index) in providerList" :key="index" @click="requestPaymentByItem(item)">{{ item.name }}</button>
+    </template>
+    <template v-else>
+      <button class="payment-button" type="primary">请先在 manifest.json 配置勾选微信支付、支付宝</button>
+    </template>
+  </view>
+</template>
+
+<style>
+  .payment-content {
+    padding: 0 10px;
+  }
+
+  .payment-button {
+    margin-top: 20px;
+  }
+</style>
+
+```
+
+## 通用类型
+
+### GeneralCallbackResult @generalcallbackresult-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errMsg | string | 是 | 错误信息 |
+
+## API源码和更多SDK功能
+
+App平台，微信和支付宝的SDK，除了requestPayment API封装的功能，还有一些其他功能。如开发者需要调用这些SDK的其他API，可以使用uts直接调用（注意打包时勾选相应的模块）
+
+可以参考uni.requestPayment的源码，也是通过uts调用这2个原生SDK：
+- [支付宝](https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-payment-alipay)
+- [微信](https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-payment-wxpay)
+
+## 自定义支付provider接入到uni API @customprovider
+
+背景：目前uni-app x引擎已经内置了支付宝支付、微信支付。但支付SDK还有很多，比如银联SDK。
+
+以往这些SDK可以通过独立插件的方式集成到uni-app x中，但需要提供单独的API给开发者使用。
+
+uni-app x从4.25起，开放了provider自接入机制，让三方SDK可以以[provider](./provider.md)方式被开发者集成。
+
+开发一个UTS插件，对接uni规范化的API、错误信息描述等实现自己的支付插件，这样插件使用者就可以通过uni的标准API使用三方SDK。
+
+举个例子，开发者想使用uni.requestPayment()的方式调用XX支付，但是内置支付api不支持，
+
+那只需要按照下面四个步骤实现即可:
+
+第一步，新建一个UTS插件，在interface.uts 中定义接口，继承UniPaymentProvider，代码如下
+
+```ts
+export interface UniPaymentAlipayProvider extends UniPaymentProvider{}
+```
+
+第二步，在app-android或者app-ios的index.uts中实现接口，代码如下
+
+```ts
+import { UniPaymentAlipayProvider } from '../interface.uts'
+export class UniPaymentAlipayProviderImpl implements UniPaymentAlipayProvider{
+	override id : String = "XX" // id必须有插件作者前缀，避免冲突，避免不同插件作者的插件id重名
+	override description : String = "XX的描述"
+	override isAppExist : boolean | null = null
+
+	constructor(){}
+
+	override requestPayment(options : RequestPaymentOptions) {
+		//todo 具体逻辑，接收uni规范的入参，进行业务处理，返回uni规范的返回值。如遇到错误，按uni的规范返回错误码
+	}
+}
+```
+
+第三步，在manifest.json中配置
+
+```ts
+  "app": {
+    "distribute": {
+      /* android打包配置 */
+      "modules": {
+        "uni-payment":{
+          "XX":{}
+        }
+      }
+    }
+  }
+```
+
+第四步，打包自定义基座然后运行
+
+由于uni-app x内置的支付API也是基于这套规范实现的，所以推荐参考
+[uni-app x支付宝支付插件的实现源码](https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-payment-alipay)

package/data/uniappx/api/request-system-permission.md

@@ -0,0 +1,220 @@
+::: sourceCode
+## uni.requestSystemPermission(options) @requestsystempermission
+
+申请系统权限
+
+### requestSystemPermission 兼容性  
+| Web | 微信小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- |
+| <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.25 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 5.25 |
+
+### 参数 
+
+| 名称 | 类型 | 必填 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| options | **RequestSystemPermissionOptions** | 是 | Web x / 微信小程序 x / iOS x（部分支持，见上） | 请求系统权限参数 |
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| permissions | Array&lt;string&gt; | 是 | Web x / 微信小程序 x / iOS x（部分支持，见上） | 申请的系统权限列表 |
+| success | (result: [RequestSystemPermissionSuccess](#requestsystempermissionsuccess-values)) => void | 否 | Web x / 微信小程序 x / iOS x（部分支持，见上） | 申请系统权限成功回调 |
+| fail | (result: [RequestSystemPermissionFail](#requestsystempermissionfail-values)) => void | 否 | Web x / 微信小程序 x / iOS x（部分支持，见上） |  |
+| complete | (result: any) => void | 否 | Web x / 微信小程序 x / iOS x（部分支持，见上） |  | 
+
+#### RequestSystemPermissionSuccess 的属性值 @requestsystempermissionsuccess-values 
+
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| grantedList | Array&lt;string&gt; | 是 | Web x / 微信小程序 x / iOS x（部分支持，见上） | 已授权权限列表，仅包含当前系统支持的权限 |
+| deniedList | Array&lt;string&gt; | 是 | Web x / 微信小程序 x / iOS x（部分支持，见上） | 已拒绝权限列表 |
+| doNotAskAgainList | Array&lt;string&gt; | 是 | Web x / 微信小程序 x / iOS x（部分支持，见上） | 不在询问权限列表 |
+
+#### RequestSystemPermissionFail 的属性值 @requestsystempermissionfail-values 
+
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| errCode | number | 是 | Web x / 微信小程序 x / iOS x（部分支持，见上） | 错误码 |
+| 合法值 | 兼容性 | 描述 |
+| :- |  :-: | :- |
+| 1560601 | Web x / 微信小程序 x / iOS x（部分支持，见上） | 申请权限为空 |
+| 1560604 | Web x / 微信小程序 x / iOS x（部分支持，见上） | 不支持申请权限 |
+| errSubject | string | 是 | Web x / 微信小程序 x / iOS x（部分支持，见上） | 统一错误主题（模块）名称 |
+| data | any | 否 | Web x / 微信小程序 x / iOS x（部分支持，见上） | 错误信息中包含的数据 |
+| cause | Error | 否 |   | 源错误信息，可以包含多个错误，详见SourceError |
+| errMsg | string | 是 | Web x / 微信小程序 x / iOS x（部分支持，见上） |  |
+
+### 示例
+
+示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/API/request-system-permission/request-system-permission.uvue)，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/API/request-system-permission/request-system-permission.uvue) 
+>
+> 该 API 不支持 Web，请运行 hello uni-app x 到 App 平台体验 
+
+::: preview
+> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/API/request-system-permission/request-system-permission
+```uvue
+<template>
+  <scroll-view class="page-scroll-view">
+    <page-head title="requestSystemPermission"></page-head>
+    <view class="uni-padding-wrap uni-common-mt">
+      <view class="uni-list">
+        <view class="uni-list-cell">
+          <view class="uni-list-cell-db">
+            <textarea
+              class="permission-input"
+              v-model="data.permissionText"
+              placeholder="请输入权限名称，多个权限使用逗号分隔"
+            />
+          </view>
+        </view>
+      </view>
+
+      <view class="uni-btn-v uni-common-mt">
+        
+        <button @tap="selectAccelerometer">加速度计权限</button>
+        <button @tap="selectLocation">定位权限</button>
+        <button @tap="selectUnconfigured">未配置权限</button>
+        
+        
+        <button @tap="selectCamera">相机权限</button>
+        <button @tap="selectLocation">定位权限</button>
+        
+        <button id="request-permission" type="primary" @tap="requestPermission">申请权限</button>
+      </view>
+
+      <view class="result uni-common-mt">
+        <text class="result-title">申请结果</text>
+        <text class="result-text">状态：{{ data.status }}</text>
+        <text class="result-text">errCode：{{ data.errCode }}</text>
+        <text class="result-text">errMsg：{{ data.errMsg }}</text>
+        <text class="result-text">grantedList：{{ (data.grantedList).join(', ') }}</text>
+        <text class="result-text">deniedList：{{ (data.deniedList).join(', ') }}</text>
+        <text class="result-text">doNotAskAgainList：{{ (data.doNotAskAgainList).join(', ') }}</text>
+      </view>
+    </view>
+  </scroll-view>
+</template>
+
+<style>
+  .permission-input {
+    width: 100%;
+    height: 100px;
+    padding: 10px;
+    box-sizing: border-box;
+  }
+
+  .result {
+    padding: 12px;
+    border: 1px solid #dddddd;
+  }
+
+  .result-title {
+    font-size: 18px;
+    font-weight: bold;
+    margin-bottom: 8px;
+  }
+
+  .result-text {
+    margin-bottom: 6px;
+  }
+</style>
+
+```
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.device.requestSystemPermission)
+- [参见uni-app相关文档](https://uniapp.dcloud.net.cn/api/plugins/request-system-permission.html)
+- [微信小程序文档](https://developers.weixin.qq.com/doc/search.html?source=enter&query=requestSystemPermission&doc_type=miniprogram)
+- [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=requestSystemPermission&pageIndex=1&pageSize=10&source=doc_top&type=all)
+- [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=requestSystemPermission&scope=devdocs&source=docs)
+- [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=requestSystemPermission&secondType=all&type=1)
+- [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=requestSystemPermission&topicFilter=)
+- [钉钉小程序文档](https://open.dingtalk.com/search?keyword=requestSystemPermission)
+- [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
+- [快手小程序文档](https://developers.kuaishou.com/page?keyword=requestSystemPermission&from=docs)
+- [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
+- [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
+- [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
+
+### 示例
+
+示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/API/request-system-permission/request-system-permission.uvue)，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/API/request-system-permission/request-system-permission.uvue) 
+>
+> 该 API 不支持 Web，请运行 hello uni-app x 到 App 平台体验 
+
+::: preview
+> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/API/request-system-permission/request-system-permission
+```uvue
+<template>
+  <scroll-view class="page-scroll-view">
+    <page-head title="requestSystemPermission"></page-head>
+    <view class="uni-padding-wrap uni-common-mt">
+      <view class="uni-list">
+        <view class="uni-list-cell">
+          <view class="uni-list-cell-db">
+            <textarea
+              class="permission-input"
+              v-model="data.permissionText"
+              placeholder="请输入权限名称，多个权限使用逗号分隔"
+            />
+          </view>
+        </view>
+      </view>
+
+      <view class="uni-btn-v uni-common-mt">
+        
+        <button @tap="selectAccelerometer">加速度计权限</button>
+        <button @tap="selectLocation">定位权限</button>
+        <button @tap="selectUnconfigured">未配置权限</button>
+        
+        
+        <button @tap="selectCamera">相机权限</button>
+        <button @tap="selectLocation">定位权限</button>
+        
+        <button id="request-permission" type="primary" @tap="requestPermission">申请权限</button>
+      </view>
+
+      <view class="result uni-common-mt">
+        <text class="result-title">申请结果</text>
+        <text class="result-text">状态：{{ data.status }}</text>
+        <text class="result-text">errCode：{{ data.errCode }}</text>
+        <text class="result-text">errMsg：{{ data.errMsg }}</text>
+        <text class="result-text">grantedList：{{ (data.grantedList).join(', ') }}</text>
+        <text class="result-text">deniedList：{{ (data.deniedList).join(', ') }}</text>
+        <text class="result-text">doNotAskAgainList：{{ (data.doNotAskAgainList).join(', ') }}</text>
+      </view>
+    </view>
+  </scroll-view>
+</template>
+
+<style>
+  .permission-input {
+    width: 100%;
+    height: 100px;
+    padding: 10px;
+    box-sizing: border-box;
+  }
+
+  .result {
+    padding: 12px;
+    border: 1px solid #dddddd;
+  }
+
+  .result-title {
+    font-size: 18px;
+    font-weight: bold;
+    margin-bottom: 8px;
+  }
+
+  .result-text {
+    margin-bottom: 6px;
+  }
+</style>
+
+```
+
+## 通用类型
+
+### GeneralCallbackResult @generalcallbackresult-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errMsg | string | 是 | 错误信息 |