Biometric Web SDK

High-performance biometric integration for web applications using Futronic scanners. Fast, flexible, and production-ready.

Integration

Seamless Integration

Plug-and-play JavaScript library for easy enrollment and verification across browsers and frameworks.

Scanner

Powerful C++ Backend

The lightweight C++ Web API service bridges the browser and the hardware, ensuring secure local communication.

Backend

Introduction

The Biometric Web API SDK provides a complete, production-ready solution for integrating Futronic fingerprint scanners into any web application. The core of the project is a high-performance C++ Web API that runs as a local service on a client's machine, bridging the communication gap between the browser and the hardware.

This package is designed for flexibility. You can integrate the included JavaScript library directly into your existing projects (whether plain HTML/JS, React, Vue, Angular, etc.) or use the full-featured Laravel example application as a starting point for a complete member management and authentication system.

Core Features

Standalone C++ Web API

Self-contained executable exposing RESTful endpoints for scanning without server dependencies.

Frontend Integration

Use our JS SDK or Laravel example app with CRUD, multi-finger enrollment, and live verification.

1:N & 1:1 Verification

Perform both member identification and user-specific validation with precision.

IoT Smart Cloud Demo

Experience the live demo of our IoT-powered Biometric SDK in action.

Installation & Demo

1
Connect Your Scanner

Attach the Futronic fingerprint scanner to a USB port.

Connect Scanner
2
Run the Installer

Run Biometric_Web_API_Installer.exe to install drivers and the API service.

3
Test the SDK

Open scan.html for live mode or demoScan.html for simulation.

C++ Web API SDK Documentation

The Biometric Web API simplifies integration of Futronic fingerprint scanners into web applications. It’s a high-performance C++ server (webapi.exe) that communicates directly with the device and exposes a REST API for the browser.

  • ✅ Built with Visual Studio 2022 (x64)
  • 💻 Runs locally on Windows 10+
  • 🔗 REST endpoints: /api/scan/single & /verify_with_template
  • 📦 Includes full frontend + backend examples
Documentation
      codecanyon_package/
      ├── documentation/
      │   └── documentation.html
      ├── executables/
      │   ├── webapi.exe
      │   ├── ftrDriverSetup_win8_whql_3471.exe
      ├── source/
      │   ├── frontend/
      │   └── server/
      │       └── webapi.sln
      └── README.md
      
GET /api/scan/single

Initiates a fingerprint scan and returns Base64 image & template.

{ 
      "success": true,
      "imageBase64": "data:image/bmp;base64,...",
      "templateBase64": "...",
      "message": "Scan successful"
      }
POST /verify_with_template

Verifies a live scan against stored fingerprint templates.

{
      "success": true,
      "verified": true,
      "message": "Match found"
      }

Demo Mode & Frontend Integration

Simulate Fingerprint Scanning

Don’t have a physical scanner? No problem — the Biometric Web SDK includes a Demo Mode that generates fake fingerprints and templates. Perfect for testing enrollment and verification without hardware.

  • 🧩 Open demoScan.html from sdk_package/source/src/frontend/.
  • 🖱️ Click “Start Demo” to simulate fingerprint enrollment.
  • 💡 All UI elements behave exactly like live mode.
demo-ui.html

    <div id="scanner-container"></div>

    <script type="module">
    import BiometricScanner from './biometric-scanner-lib.js';
    const scanner = new BiometricScanner('#scanner-container', { verification: false });
    </script>
    

💻 Advanced Examples

enrollment.js

    document.addEventListener('enrollmentComplete', (e) => {
    const data = e.detail.scannedData;
    document.getElementById('template1').value = data.left[0].templateBase64;
    });
    
verification.js

    const scanner = new BiometricScanner('#scanner-container', { verification: true });
    document.addEventListener('verificationComplete', async (e) => {
    await axios.post('/verify', { template: e.detail.template });
    });
    

🧠 Troubleshooting

“Local Service Required”

Ensure webapi.exe is running on localhost:8080.

“Fingerprint Scanner Not Detected”
  • Reconnect your Futronic scanner via USB.
  • Reinstall ftrDriverSetup_win8_whql_3471.exe.
  • Check Device Manager for driver conflicts.

Security & Data Privacy

The Biometric Web SDK is designed with privacy and data protection at its core. No raw fingerprint images are ever stored or transmitted outside the user’s machine. Instead, encrypted biometric templates are generated locally and used only for matching.

  • Template-based storage: Only mathematical templates are saved, not fingerprint images.
  • Local processing: Scanning and template generation occur entirely on the client’s system.
  • Secure transmission: All communication with backend servers must use HTTPS.
  • Compliance: Designed to align with GDPR, HIPAA, and local data protection standards.
  • Optional Encryption: Templates can be AES-256 encrypted before saving to the database.
Security Illustration

Deployment & Packaging

Client Deployment
  • Distribute webapi.exe and drivers to each end-user machine.
  • Use Biometric_Web_API_Installer.exe for simplified installation.
  • Ensure the service is allowed through Windows Firewall on port 8080.
Server Deployment
  • Host your Laravel or Node backend on any web server (Apache, Nginx, IIS).
  • Use HTTPS endpoints to receive template data from frontend.
  • Secure database credentials and disable directory indexing.

Frequently Asked Questions

Quick answers about setup, integration, and biometric data operations.

The browser requires a connection to your local webapi.exe service. Ensure it's running and accessible at http://localhost:8080 to bridge the web app and fingerprint scanner.

Yes. The SDK runs fully offline — all operations happen locally between your browser and the Web API service. This ensures zero external data exposure and total privacy.

All Futronic devices (FS80H, FS81H, FS88H) are supported through the FTRAPI SDK. Additional IoT-ready sensor support will arrive in future updates.

Absolutely. Each client system just needs the runtime (webapi.exe + drivers). For IoT deployments, silent installer scripts can automate this process at scale.

Need Help or Support?

We’re here to assist you with installation, integration, and deployment of your Biometric SDK.