Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Complete an age verification

This tutorial continues from Run the verifier app. With the verifier app running and an operator signed in, you generate a QR code, scan it with a wallet, and read the verified result.

What you need

Steps

1. Select the credential type

On the control page, open the credential type selector and choose the type that your wallet holds. The default type is Proof of Age.

When the server allows only one credential type, the app hides the selector and starts the transaction automatically.

2. Generate the QR code

Click Generate QR Code.

Expected: the page shows a QR code and a status badge with the value pending. The app polls the transaction every 2 seconds.

3. Scan the QR code

Open the wallet on the holder device, choose the option to present a credential, and scan the QR code. Approve the request.

Expected: the status badge changes from pending to verified.

4. Read the result

When the badge shows verified, the holder presentation passed verification. The page shows the verified claims, which for a Proof of Age credential is the boolean claim age_over_18. Click New Verification to start another transaction.

The status values

StatusMeaning
pendingThe wallet has not answered the request.
receivedThe wallet returned a presentation.
verifiedThe credential passed verification.
failedThe credential failed verification.
errorThe transaction failed with an error.
expiredThe transaction passed its time to live.

A failed result shows the errors that the verifier returned. The most common cause is an untrusted issuer. See the security model.

What happened

In step 2 the verifier app asked the credential verifier to start a transaction. The credential verifier created a random nonce, stored the transaction, and returned an OpenID4VP authorization request. The QR code carries that request.

In step 3 the wallet read the request, built a verifiable presentation from the stored credential, and sent the presentation to the credential verifier. The credential verifier read the nonce from its own transaction store, compared it with the nonce in the presentation, verified the issuer signature and the holder signature, and signed an attestation.

In step 4 the verifier app read the transaction status and showed the result. The verifier recorded the verification in its journal, when the journal is enabled.

Troubleshooting

SymptomCauseAction
The badge stays pendingThe wallet did not scan the code.Scan the code again, or generate a new code.
The QR code expires before the scanThe transaction passed its time to live.Generate a new QR code.
The result is failedThe credential failed a check.Read the errors. An untrusted issuer is the common cause.
QR generation returns 400The credential type is not allowed.Check allowed_credential_types and the per-user types.
The wallet rejects the requestThe wallet does not trust the verifier.Load the verifier CA certificate into the wallet trust store.

Next steps