累计: 0

电子支付收银台状态查询功能说明书

0.00

★37次@未来之窗

A:赛忞初雪

上架: 2026-03-01 00:49:56

电子支付收银台状态查询功能说明书

         收藏
 

四方仙域传送阵         

电子支付收银台状态查询功能说明书

电子支付收银台状态查询功能说明书

未来之窗昭和仙君 - cyberwin_fairyalliance_webquery

一、功能概述

此支付状态查询功能用于轮询订单的支付状态。支持自定义查询接口地址、查询间隔、最大重试次数等参数,同时提供了支付成功、支付失败和其他错误的回调函数。在首次调用时会弹出等待进程对话框,可自定义对话框的样式和提示信息。此外,还支持在支付成功后关闭窗口的功能。

二、调用格式

$cq.wlzc_pay_polling_payment(options);
$cq.未来之窗_支付交互_收银台查询结果(options);
$cq.fams_paystatusquery(options);
$cq.fams_wppp(options);

三、参数说明

参数 类型 是否必填 默认值 说明
apiUrl string "http://yourquery.com/" 自定义查询接口地址
onSuccess function 打印支付成功信息到控制台 支付成功回调函数,接收查询结果作为参数
onFail function 打印支付失败信息到控制台 支付失败回调函数,接收查询结果作为参数(状态码 9417 等终止性失败)
onError function 打印查询异常信息到控制台 其他错误回调函数,接收查询结果作为参数(非终止性错误/循环等待)
close: string Y Y/N 等待进程对话框中点击进行终止操作
barbg string '#1890ff' 主题色(用于提示框等)
interval number 1000 查询间隔(避免高频递归,单位:毫秒)
maxRetries number 30 最大重试次数(防止无限递归)
retryCount number 0 已重试次数(内部参数,无需手动传)
skin string "maskwait" 等待进程对话框的皮肤样式
wait_title string "等待完成支付" 等待进程对话框的标题
wait_tips string "请勿关闭等待完成" 等待进程对话框的提示信息
wait_centerText string "查询中" 等待进程对话框中间的文字
wait_result string "正在查询状态........" 等待进程对话框的结果信息
onPoll function 打印正在查询信息到控制台 每次轮询时的回调函数,接收查询结果作为参数

四、返回值

五、使用示例

示例 1


function test1() {
    $cq.wlzc_pay_polling_payment({
        apiUrl: 'https://www.baidu.com/',
        close: "Y",
        barbg: 'rgb(6 21 33)',
        interval: 2000,
        maxRetries: 10,
        wait_title: "等待支付完成,请勿着急",
        wait_tips: "耐心等待支付结果,可点击终止",
        onSuccess: function(result) {
            console.log('自定义成功逻辑:', result);
            alert('支付成功!订单号:' + result.current_order_id);
        },
        onFail: function(result) {
            console.log('自定义交易失败::', result);
        },
        onError: function(result) {
            console.log('自定义错误,请刷新页面重试:', result);
        },
        onPoll: function(result) {
            console.log('自定义轮询:', result);
        }
    });
}
        

示例 2


function test2() {
    $cq.wlzc_pay_polling_payment({
        apiUrl: 'https://www.baidu.com/',
        close: "Y",
        barbg: 'rgb(255 102 0)',
        interval: 2000,
        maxRetries: 10,
        wait_title: "请耐心等待支付完成",
        wait_tips: "不要关闭窗口,等待支付结束,点击可终止",
        onSuccess: function(result) {
            console.log('自定义成功逻辑:', result);
            alert('支付成功!订单号:' + result.current_order_id);
        },
        onFail: function(result) {
            console.log('自定义交易失败::', result);
        },
        onError: function(result) {
            console.log('自定义错误,请刷新页面重试:', result);
        },
        onPoll: function(result) {
            console.log('自定义轮询:', result);
        }
    });
}
        

六、注意事项

  • 当重试次数超过最大重试次数时,会终止查询并调用错误回调函数。
  • 在首次调用时会弹出等待进程对话框,可通过相关参数自定义对话框的样式和提示信息。
  • 若设置了 `close` 为 "Y",可在等待进程对话框中点击进行终止操作。

硬件app