开发 uniapp App支付宝当面付 uniapp如何集成扫码支付|Duuu笔记

前端进阶技巧：本文深入解析

不能。uni.requestPayment仅支持主扫（用户扫商户码），当面付需商户扫用户付款码，必须通过原生插件集成支付宝SDK，并由服务端生成二维码、前端展示及轮询结果。

uni.requestPayment 能不能直接调起当面付？

不能。当面付（扫码支付）和

uni.requestpayment

完全是两套逻辑：

uni.requestpayment

是用于唤起用户手机上的支付宝 app 完成「主扫」（用户扫商户码），而当面付是「被扫」——商户用设备扫用户的付款码，必须由服务端生成支付二维码，前端只负责展示和轮询结果。

当面付集成必须走原生插件吗？

是的，纯 H5 或

uni.requestPayment

无法完成「扫码枪/摄像头扫用户付款码」这个动作。uni-app 官方不提供当面付 SDK 封装，必须使用原生能力：

安卓端需集成支付宝官方

alipaysdk-*.aar

，并编写

native.js

模块桥接扫码识别与支付初始化

iOS 端需引入

AlipaySDK.framework

，配置

URL Scheme

（如

alipay{appid}

），并实现

APAuthV2Info

序列化支持

插件市场里搜“支付宝原生扫码”，购买后务必在 HBuilderX 中「关联到当前项目」，否则

nativeplugins/

下不会生成任何文件

manifest.json 配置最容易漏哪几项？

当面付依赖原生能力，但很多开发者只配了支付白名单，却忘了基础权限和 URL 规则：

安卓必须在

manifest.json → app-plus → permissions

中显式声明：

和

app-plus → distribute → alipay → urls

不只要填

alipays://*

，还得加

https://qr.alipay.com/*

（用于跳转到支付宝确认页）

包名（

android-package-name

）必须和支付宝开放平台「应用信息」里填写的完全一致，包括大小写和点号位置；签名证书指纹也必须提前录入沙箱/正式环境

服务端返回的二维码怎么安全展示？

支付宝返回的是类似

https://qr.alipay.com/fkx01234abcde567890

这样的短链，不能直接

img src

加载——部分安卓 WebView 会拦截跳转，iOS 可能因 ATS 限制加载失败：

推荐用

加载一个本地 HTML 页面，在其中用 JS 创建

img

标签并设置

src

，避免跨域或协议限制

更稳妥的做法是服务端将二维码 base64 数据直接返回（字段如

qr_code_base64

），前端用

渲染

轮询支付结果时，别用

setInterval

直接轮，应配合服务端幂等接口 + 指数退避（比如首次 2s，失败后 4s、8s…最大 30s），避免触发支付宝风控限流

当面付不是“前端调个 API 就完事”的功能，它本质是「软硬结合」：前端要控制扫码硬件、展示动态码、处理中断；服务端要扛住并发轮询、做幂等校验、及时关单；支付宝侧还要对应用类型、密钥、回调地址做严格校验——任一环节松动，扫码就卡在“正在处理”或直接报错

INVALID_PARAMETER

。