1. 接入说明
趣工宝
  • 接入说明
    • 签名说明v2(标准对接)
    • 签名说明v1(历史对接客户)
    • 微信小程序嵌入签约(法大大)
    • app嵌入签约(法大大)
  • 业务模式说明
    • 客户标准对接
    • 业务代理模式
  • 平台接入
    • 1.客户基本接口
      • 客户信息列表查询接⼝
      • 客户注册审核通知
      • 客户费率更新
      • 客户线下实名接⼝
      • 客户实名查询
      • 实名回调通知
      • 客户实名接⼝
      • 客户信息修改
      • 客户信息查询接⼝
      • 客户注册接⼝
    • 2.客户账户类接口
      • 客户余额查询
      • 客户充值查询
      • 客户充值申请
      • 查询充值记录列表
    • 3.客户签约接口
      • 客户签约回调
      • 客户外部协议归档
      • 客户签约查询接⼝
      • 客户签约申请
    • 4.创客基本接口
      • 创客注册
      • 个体户创客注册
      • 查询创客信息
      • 查询创客信息列表(分页)
      • 上传会员证件照⽚
      • 变更创客姓名
      • 变更创客⼿机号信息
      • 变更创客银⾏卡号信息
      • 删除会员(测试环境)
    • 5.创客签约类接口
      • 创客签约接⼝
      • 创客批量快捷签约
      • 创客签约状态查询
      • 创客签约列表
      • 创客签约校验
      • 创客签约回调
      • 创客签约短信重发
      • 上传个人协议
      • 静默签约回调
      • 静默签约查询
      • 静默签约接⼝
      • 项目签约接⼝
    • 6.任务结算相关接口
      • 查询项目任务
      • 结算申请
      • 结算查询
      • 结算结果通知
      • 结算回单查询
      • 退票查询
      • 退票通知
      • 任务验收成果文件上传
    • 7.开票类接口
      • 开票结果查询
      • 根据流⽔单号申请开票
      • 查询可开票订单信息
      • 根据订单号申请开票
    • 8.数据类同步
      • 同步任务信息
      • 可开票类目查询
      • 开票结果查询
      • 根据订单明细开票申请
      • 订单数据同步
      • 个人协议同步接口
      • 个人信息同步接口
    • 9.涉税接口
      • 个税计算接口【同步】
      • 个税批量计算接口【异步】
      • 个税计算记录作废接口
      • 个税查询接口
      • 【诚薪通】同步个税计算接口
      • 【诚薪通】发放同步接口
      • 【外部】个税订单计算(需要确认接口生效)
      • 【外部】个税订单确认
  1. 接入说明

微信小程序嵌入签约(法大大)

1. 时序图#

image.png

2. 小程序嵌入中间页说明#

2.1 配置接入方小程序的校验文件#

具体请参见微信小程序业务域名配置说明:
https://developers.weixin.qq.com/miniprogram/dev/framework/ability/domain.html

2.2 在接入方小程序的app.json中,增加分包配置代码。#

2.3 请查阅“刷脸小程序跳转中间页DEMO”代码包 ,并替换pagesFace目录下的全部文件,放置示#

下载地址: https://static.fadada.com/示例视频及demo代码包.zip
image.png

2.4. 通过集成法大大服务端API接口(详见接口文档),获取到对应签署方式集成页面链接,在打开这些链接的页面中,增加reloadPage方法(可参考webview.js)。#

注意:传递的参数需经过encodeURIComponent处理。

3. 返回小程序内部(wxReturnUrl)#

3.1. 客户自己提供returnUrl,#

签约完成时会跳转到这个地址,可自行选择跳转页面,示例跳转代码如下
function returnWxApp() {
    // 判断当前环境是否为小程序
    const ua = navigator.userAgent.toLowerCase();
    if (ua.match(/MicroMessenger/i) == 'micromessenger') {
        wx.miniProgram.getEnv((res) => {
            if (res.miniprogram) {
                console.log('在小程序内');
                let url = getCallbackPagePath()
                // 此处为tabbar页面跳转判断,若需要跳转至其他tabbar页面
                //请在下方if判断中添加
                if (url === '/pages/index/index') { 
                    // 此处以/pages/index/index为例                            
                    wx.miniProgram.switchTab({
                        url,
                        success: (res) => {
                            console.log(res);   // 页面跳转成功的回调函数
                        },
                        fail: (err) => {
                            console.log(err);   // 页面跳转失败的回调函数
                        }
                     });
                 } else {
                     // 非tabbar页面跳转
                     wx.miniProgram.redirectTo({
                         url,
                         success: (res) => {
                             console.log(res);   // 页面跳转成功的回调函数
                         },
                         fail: (err) => {
                             console.log(err);   // 页面跳转失败的回调函数
                         }
                     });
                  }
              } else {
                  console.log('不在小程序内');
              }                
        });
    } else {
         console.log('不在微信浏览器内');
    }
    console.log('callbackPagePath' + getCallbackPagePath());
}
function getCallbackPagePath() {
    // 获取完整的URL            
    var url = window.location.href;            
    // 解析URL中的参数            
    var urlParams = new URLSearchParams(url.substr(url.indexOf('?')));            
    console.log('urlParams=' + urlParams);            
    // 获取回调页面路径参数            
    var pageUrl = urlParams.get('callbackPagePath');            
    console.log('pageUrl=' + pageUrl);            
    return pageUrl != null ? pageUrl : '/pages/index/index';        
}

3.2 wxReturnPage 为页面返回地址(如:pages/index/index)#

签约完成后,小程序会跳转到趣工宝提供returnUrl 的中间页,页面加载后会跳转到 wxReturnPage
( 默认 renturnUrl 地址为 https://static.qugongbao.com/webview-callback/#/fdd/signReturn)

4. 小程序白名单配置对接流程#

1
客户方,提供小程序校验文件
1.
提供小程序校验文件
2.
提供小程序appid和主体名称
2
趣工宝,配置校验文件 nginx
访问链接 https://static.qugongbao.com/xxxxx.txt
3
法大大,配置校验文件及域名
1.
法大大分配域名(接口请求地址,api接口请求域名)
2.
配置到趣工宝系统
4
客户配置微信小程序请求白名单
1.
https://static.qugongbao.com/webview-callback/#/fdd/signReturn
2.
法大大提供的接口域名和实名认证域名
注意,接口参数source 传 WxMini
修改于 2026-01-05 06:00:00
上一页
签名说明v1(历史对接客户)
下一页
app嵌入签约(法大大)
Built with