更新记录

1.0.2（2026-04-22）

更新说明

1.0.1（2026-04-22）

更新文档

1.0.0（2026-04-22）

初版发布

平台兼容性

uni-app(5.04)

uni-app x(5.04)

lkl-pay-webview

原生 WebView 桥接插件，用于承载第三方拉卡拉支付页面，并把 H5 调用 LKLWebObject 的结果回传给 uni-app 页面处理。

插件同时提供了支付场景封装 openLklPayWebView，可在插件内部自动处理支付宝拉起和微信小程序拉起 用户从支付宝或微信返回 App 时，插件会额外回调 returnExternalApp 事件，页面层只需要查单和决定何时关闭原生 WebView。

支持的平台

• Android App
• iOS App

uni-app 页面接入示例

通用模式

<script setup>
import { openLklWebView,closeLklWebView } from '@/uni_modules/lkl-pay-webview'

const openPayWeb = (url) => {
 openLklPayWebView({
    url: counterUrl,
    title: '收银台'
}, (result) => {
    handleNativeWebViewResult(result);
});
}
const handleNativeWebViewResult = (result, orderId) => {
    console.log("[pay-web 支付回调]：",result)
    if (!result || !result.action) {
        return;
    }

    if (result.action === 'jumpWxApplet') {
        console.log("[pay-web 支付回调]：打开微信支付", result) 
        return;
    }

    if (result.action === 'jumpAlipay') {
        console.log("[pay-web 支付回调]：打开支付宝支付", result) 
        return;
    }

    if (result.action === 'returnAlipay') {
        console.log("[pay-web 支付回调]：支付宝支付返回", result)  
        // 验证成功后主动调closeLklWebView() 关闭支付页面
        return;
    }

    if (result.action === 'returnExternalApp') {
        console.log("[pay-web 支付回调]：支付返回", result)  
        // 验证成功后主动调closeLklWebView() 关闭支付页面
        return;
    }

    if (result.action === 'closeWindow') {
        if (result.closeReason === 'userClose') {
            console.log("[pay-web 支付回调]：用户主动关闭额面", result)  

        } else {
            console.log("[pay-web 支付回调]：关闭支付页面", result)
        }
    }
};

其中支付直连场景最常用的是：

• action = 'jumpAlipay'：H5 请求拉起支付宝
• action = 'jumpWxApplet'：H5 请求拉起微信小程序
• action = 'returnExternalApp'：插件检测到用户从外部应用重新回到 App
• action = 'returnAlipay'：H5 主动通知“已从支付宝回流”，用于兼容旧页面
• action = 'closeWindow'：H5 或原生关闭当前支付页

closeWindow 常见的 closeReason：

• userClose：用户点击原生关闭按钮，或 Android 返回键关闭支付页
• webClose：支付 H5 主动调用 closeWindow()
• programClose：业务代码调用 closeLklWebView() 主动关闭

说明

• openLklWebView 只负责打开原生 WebView 和接收 H5 消息
• openLklPayWebView 位于 pay.js，会在 JS 封装层自动处理 jumpAlipay 和 jumpWxApplet
• 直接在业务页面调用 openLklPayWebView 即可
• 当用户从支付宝或微信返回 App 时，插件会主动回调 returnExternalApp，页面可直接查单
• 当收到 closeWindow 且 closeReason === 'userClose' 时，建议补一次查单，避免用户先支付成功再手动关闭
• returnAlipay 与 closeWindow 仍然会回调给页面，便于兼容旧逻辑与控制返回