uni.requestPayment是一个统一各平台的客户端支付API，不管是在某家小程序还是在App中，客户端均使用本API调用。

本API运行在各端时，会自动转换为各端的原生支付调用API。

虽然客户端API统一了，但各平台的支付申请开通、配置回填、服务器开发，仍然需要看各个平台本身的支付文档。

比如微信有App支付、小程序支付、H5支付等不同的申请入口和使用流程，对应到uni-app，在App端要申请和使用微信的App支付，而小程序端则申请和使用微信的小程序支付。

平台差异说明

OBJECT 参数说明

参数名类型必填说明平台差异说明
providerString是分享服务提供商，通过 uni.getProvider 获取。
orderInfoString/Object是订单数据，5+App、支付宝小程序、百度小程序、头条小程序
timeStampString微信小程序必填时间戳从1970年1月1日至今的秒数，即当前的时间。微信小程序
nonceStrString微信小程序必填随机字符串，长度为32个字符以下。微信小程序
packageString微信小程序必填统一下单接口返回的 prepay_id 参数值，提交格式如：prepay_id=xx。微信小程序
signTypeString微信小程序必填签名算法，暂支持 MD5。微信小程序
paySignString微信小程序必填签名，具体签名方案参见 微信小程序支付文档微信小程序
bannedChannelsArray<String>否需要隐藏的支付方式，详见 百度小程序
successFunction否接口调用成功的回调
failFunction否接口调用失败的回调函数
completeFunction否接口调用结束的回调函数（调用成功、失败都会执行）

orderInfo 注意事项

  • 百度小程序的 orderInfo 为 Object 类型，详细的数据结构，参考：百度收银台支付。
  • 支付宝小程序的 orderInfo(支付宝的规范为 tradeNO) 为 String 类型，表示支付宝交易号。
  • 头条小程序的 orderInfo(头条的规范为 data) 为 Object 类型，详见：
  • App端，支付宝支付和微信支付 orderInfo 均为 String 类型。
  • App端，苹果应用内支付 orderInfo 为Object 类型，{productid: 'productid'}。

H5 平台

  • 普通浏览器平台的支付，仍然是常规web做法。uni-app未封装。
  • 在普通浏览器里也可以调起微信进行支付，这个在微信叫做H5支付，此功能未开放给普通开发者，需向微信单独申请，详见
  • App 里支持微信sdk支付、支付宝sdk支付、苹果iap应用内支付，在各平台申请支付时选择 App 支付。
  • 其他支付（如银联）请使用web-view组件以H5方式实现。
  • 支付宝小程序只支持支付宝支付。
  • 百度小程序为百度支付，其二次封装了度小满、支付宝、微信支付。
  • Hello uniapp 里演示了各种支付（iap支付见社区文章底部的赞助按钮），同时该示例开源了对应的服务端源码，参考：。

App平台支付流程

流程：支付平台功能申请 -> 里配置支付参数 -> uni-app 里调用 API 进行支付

App支付功能申请

  • 支付宝App支付功能申请

    登录支付宝账号，创建应用接入支付宝App支付能力，包括以下步骤：

    • 创建应用（获取appid）
    • 开通App支付功能
    • 配置密钥（获取公钥、私钥）具体可参考支付宝官方文档： App支付快速接入

  • 微信App支付功能申请

    • 到 申请移动应用并开通支付功能，申请应用后可以获取 AppID 和 AppSecret 值
    • 应用接入 微信商户平台，选择 App 支付
    • 开通支付功能后可获取支付业务服务器配置数据：PARTNER（财付通商户号）、PARTNER_KEY（财付通密钥）、PAYSIGNKEY（支付签名密钥）
    • 需要将从微信开放平台申请的appid，填回到 manifest-App SDK配置-支付-微信支付 中。打包后生效。具体可参考微信官方文档：

注意微信的App支付、小程序支付、H5支付是不同的体系。微信小程序支付在 微信商户平台 申请支付时，选择公众号支付；普通浏览器里也可以调起微信进行支付，这个在微信叫做H5支付，此功能未开放给普通开发者，需向微信单独申请，

  • 使用苹果开发者账号登录 App Store Connect，在应用的功能选项卡页面，添加 App 内购项目。注意：

    • 测试时，建议使用测试证书打一个自定义的 iOS 基座进行测试
    • 在应用 TestFight 的选项卡添加 App Store Connect 用户，测试支付时可以使用此用户帐号进行测试
    • orderInfo 的 productid 是自己填写的产品 ID
    • 调用 前必须先使用 5+Plus 的方法调用 requestOrder 获取订单信息，否则会导致无法支付
    • 更多可参考：

manifest.json里配置相关参数

  • 在manifest.json - App模块权限选择 中勾选 payment(支付)
  • 在 中，勾选需要的支付平台，目前有微信支付、支付宝支付、苹果应用内支付(IAP)，其中微信支付需要填写从微信开放平台获取的AppID
  • 这些配置需要打包生效，真机运行仍然是HBuilder基座的设置，可使用自定义基座调试。离线打包请参考离线打包文档在原生工程中配置。
  • 配置并打包后，通过uni.getProvider可以得到配置的结果列表，注意这里返回的是manifest配置的，与手机端是否安装微信、支付宝无关。如果手机端未安装支付宝，调用时会启动支付宝的wap页面登陆，如果已安装相应客户端，会启动其客户端登陆。

uni-app里开发

FAQ

  • Q：如何使用ping++等聚合支付

  • A：uni-app的js API 已经完成跨端统一，客户端无需使用三方聚合支付。仅在服务器端使用三方聚合支付即可。

  • Q：App端如何集成其他支付SDK

  • A：使用原生插件方式，可以集成如paypal或三方聚合支付sdk，原生插件开发文档见。开发之前可以先去插件市场看下有没有做好的。示例

App 支付

微信小程序支付

发现错误？想参与编辑？