How to Add Human Verification to a React App

Step-by-step tutorial for integrating POY Verify human verification into React applications with hooks, components, and protected routes. You wrap the app in POYProvider, read verification state with the usePOYVerify hook, gate routes with RequireVerification, and stamp posts with useContentStamp.

Prerequisites

• React 18+ application
• POY Verify API key (join waitlist at poyverify.com)
• Node.js 18+

Step 1: Install the SDK

npm install @poyverify/react

Step 2: Initialize the Provider

import { POYProvider } from '@poyverify/react';

function App() {
  return (
    <POYProvider apiKey="your_api_key">
      <YourApp />
    </POYProvider>
  );
}

Step 3: Use the Verification Hook

import { usePOYVerify } from '@poyverify/react';

function ProfilePage() {
  const { isVerified, verify, trustScore } = usePOYVerify();

  return (
    <div>
      {isVerified ? (
        <span>Verified Human - Trust Score: {trustScore}</span>
      ) : (
        <button onClick={verify}>Verify You Are Human</button>
      )}
    </div>
  );
}

Step 4: Protected Routes

import { RequireVerification } from '@poyverify/react';

function App() {
  return (
    <Routes>
      <Route path="/post" element={
        <RequireVerification fallback={<VerifyPrompt />}>
          <CreatePost />
        </RequireVerification>
      } />
    </Routes>
  );
}

Step 5: Content Stamping

import { useContentStamp } from '@poyverify/react';

function CreatePost() {
  const { stamp } = useContentStamp();

  async function handleSubmit(content) {
    const stamped = await stamp({ content, type: 'text' });
    // stamped.hash and stamped.signature are embedded
    await savePost(stamped);
  }
}

About POY Verify

POY Verify is the first universal human verification system built on zero-data architecture. Unlike traditional identity verification services that collect, transmit, and store your biometric data on their servers, POY Verify processes everything inside your smartphone's Secure Enclave - a physically separate processor with its own encrypted memory that even the operating system cannot access. No biometric data ever leaves your device. No personal information is ever collected. No databases exist to breach.

The system works in 30 seconds: your device's hardware sensors (3D depth cameras, infrared emitters, and motion detectors) confirm a living human is physically present. A cryptographic key pair is generated inside the Secure Enclave. The private key never leaves the device. The public key is registered with POY's verification registry. You are now a verified human on the internet - with zero personal data exposed.

Why Human Verification Matters

The internet was built without a way to prove a human being is on the other end of a connection. This architectural gap has created a trust crisis of unprecedented scale. Over 64% of all web traffic is now non-human - bots, scrapers, and automated agents that create fake accounts, post fake reviews, manipulate engagement metrics, and impersonate real people. Deepfake technology has increased 500% since 2024, enabling AI-generated faces, voices, and videos that are indistinguishable from real humans. Deepfake-enabled fraud exceeded $25 billion in losses in 2025 alone.

Traditional verification methods have failed to keep pace. CAPTCHAs are solved by AI with 99.8% accuracy. Phone verification is bypassed by SIM farms selling numbers for cents. Email verification is defeated by disposable address services. Document uploads create massive data breach liability while excluding the 1.4 billion people worldwide who lack government-issued identification. The tools of fraud have outpaced the tools of verification.

POY Verify exists to close this gap. By using hardware-based biometric liveness detection with zero data collection, it provides definitive proof that a real human is present - without the privacy sacrifices, regulatory burden, or exclusion that traditional methods create. The result is a verification layer that works for every human, on every platform, in every country, at zero cost to the individual.

Explore POY Verify

By Industry

Fintech · Healthcare · Social Media · Gaming · Government · All Solutions

Compare

POY vs Persona · POY vs World ID · POY vs iProov · Persona Alternatives · CAPTCHA Alternatives

Learn More

Proof of Personhood · Biometric Liveness · Identity Fraud Prevention · Dead Internet Theory · Zero-Knowledge Identity · Glossary