Welcome to FullVerify

import { useEffect, useState } from "react";
import QRCode from "qrcode.react";
import { FullVerify } from "@fullverify/sdk";

const fv = new FullVerify({ apiKey: process.env.FULLVERIFY_API_KEY });

export default function VerificationWidget() {
  const [session, setSession] = useState(null);
  const [status, setStatus] = useState("idle");

  useEffect(() => {
    fv.sessions
      .create({
        docType: "org.iso.18013.5.1.mDL",
        requestedAttributes: ["age_over_18", "portrait"],
      })
      .then(setSession);
  }, []);

  useEffect(() => {
    if (!session) return;
    const poll = setInterval(async () => {
      const result = await fv.sessions.get(session.id);
      if (result.status === "verified") {
        setStatus("verified");
        clearInterval(poll);
      }
    }, 1000);
    return () => clearInterval(poll);
  }, [session]);

  if (!session) return <p>Initializing...</p>;
  if (status === "verified") return <p>✓ Identity verified</p>;

  return (
    <div>
      <QRCode value={session.deviceEngagementUri} size={256} />
      <p>Scan with your wallet to verify</p>
    </div>
  );
}

import os, io, base64, fullverify, qrcode
from flask import Flask, jsonify

fv = fullverify.Client(api_key=os.environ["FULLVERIFY_API_KEY"])
app = Flask(__name__)

@app.route("/verify/start")
def start_verification():
    session = fv.sessions.create(
        doc_type="org.iso.18013.5.1.mDL",
        requested_attributes=["age_over_18", "portrait"],
    )
    img = qrcode.make(session.device_engagement_uri)
    buf = io.BytesIO()
    img.save(buf)
    return jsonify({
        "session_id": session.id,
        "qr": base64.b64encode(buf.getvalue()).decode(),
    })

@app.route("/verify/result/<session_id>")
def get_result(session_id):
    result = fv.sessions.get(session_id)
    if result.status == "verified":
        return jsonify(result.disclosed_attributes)
    return jsonify({"status": result.status}), 202

import FullVerify from "@fullverify/sdk";
import QRCode from "qrcode";

const fv = new FullVerify({ apiKey: process.env.FULLVERIFY_API_KEY });

async function startVerification(canvasId) {
  const session = await fv.sessions.create({
    docType: "org.iso.18013.5.1.mDL",
    requestedAttributes: ["age_over_18", "portrait"],
  });

  const canvas = document.getElementById(canvasId);
  await QRCode.toCanvas(canvas, session.deviceEngagementUri);

  return new Promise((resolve, reject) => {
    const poll = setInterval(async () => {
      const result = await fv.sessions.get(session.id);
      if (result.status === "verified") {
        clearInterval(poll);
        resolve(result.disclosedAttributes);
      }
      if (result.status === "expired") {
        clearInterval(poll);
        reject(new Error("Session expired"));
      }
    }, 1000);
  });
}

startVerification("qr-canvas").then((attrs) => {
  console.log("age_over_18:", attrs.age_over_18);
  console.log("portrait:", attrs.portrait);
});

<?php
require_once 'vendor/autoload.php';

use FullVerify\Client;
use Endroid\QrCode\QrCode;
use Endroid\QrCode\Writer\PngWriter;

$fv = new Client(['api_key' => $_ENV['FULLVERIFY_API_KEY']]);

// Start a verification session
$session = $fv->sessions->create([
    'doc_type'             => 'org.iso.18013.5.1.mDL',
    'requested_attributes' => ['age_over_18', 'portrait'],
]);

// Render QR code from device engagement URI
$qr     = QrCode::create($session->deviceEngagementUri)->setSize(300);
$result = (new PngWriter())->write($qr);

echo '<img src="' . $result->getDataUri() . '" alt="Scan to verify"/>';
echo '<p data-session="' . $session->id . '">Scan with your wallet</p>';

// AJAX polling endpoint — /verify/result?id={session_id}
function getVerificationResult(string $sessionId): ?array {
    global $fv;
    $result = $fv->sessions->get($sessionId);
    return $result->status === 'verified'
        ? (array) $result->disclosedAttributes
        : null;
}