Verify a credential

​

Prerequisites

• The verification quickstart’s /api/verification-token and /api/verify-presentation routes.
• A schema with a tier claim, and a test user who holds a credential from an issuer you accept.

​

Step 1: Create a program that requests the tier

1. In the Developer Dashboard, go to Verifier → Programs and create a program.
2. Select the schema with the tier claim and the issuers you accept.
3. Request the tier claim, and publish the program.
4. Copy the verification program ID.

​

Step 2: Request the tier when the user opens the page

async function verifyLoyaltyTier() {
  // Your server returns a Partner JWT and a one-time nonce
  const response = await fetch("/api/verification-token", { method: "POST" });
  const { token, nonce } = await response.json();

  const result = await airService.verifyCredential({
    authToken: token,
    programId: process.env.NEXT_PUBLIC_VERIFY_PROGRAM_ID,
    fieldsToDisclose: ["tier"],
    nonce,
  });

  if (result.status === "Compliant") {
    grantAccess(result.verifiablePresentation);
  } else {
    denyAccess(result.status);
  }
}

final token = await fetchVerificationToken(); // your server endpoint

final result = await airService.verifyCredential(
  authToken: token,
  programId: verifyProgramId,
);

if (result.status == "COMPLIANT") {
  grantAccess();
} else {
  denyAccess(result.status);
}

​

Step 3: Gate the feature on the result

async function grantAccess(presentation) {
  // Verify the SD-JWT on your backend before unlocking the feature.
  const check = await fetch("/api/verify-presentation", {
    method: "POST",
    headers: { "content-type": "application/json" },
    body: JSON.stringify({ verifiablePresentation: presentation }),
  });
  if (check.ok) unlockFeature();
}

function denyAccess(status) {
  if (status === "Non-Compliant") {
    // Credential exists but fails the program's conditions — show a restricted view.
    return;
  }
  // Missing, pending, expired, or revoked credential — send the user to the
  // issuer flow or ask them to renew. Log `status` to distinguish the cases.
}

​

Next steps

• Try it live: member discount at a café or show a seller you passed an ID check
• Verifying credentials for the full result shape and selective disclosure
• Verifying your first credential for the full setup
• Schema Design to understand which fields a program can check