To test a verification end to end, you need a wallet app that holds a credential your policy accepts. Install the Authbound wallet, then issue yourself a test Authbound Digital ID with your test keys.

Install the Authbound wallet

The Authbound wallet is available for Android on Google Play. Install it and follow the setup when you first open it.

Issue yourself a test ID

Authbound has a built-in test credential, the Authbound Digital ID. A project with test keys can issue it when the global pid-credential definition is published in that environment. Use the script below to check that prerequisite. Save this script as test-id.mjs:
test-id.mjs
import { AuthboundClient } from "@authbound/server";

const authbound = new AuthboundClient({
  apiKey: process.env.AUTHBOUND_SECRET_KEY,
});

const offer = await authbound.openId4Vc.issuance.createOffer({
  credentialDefinitionId: "pid-credential",
  issuanceMode: "InTime",
  claims: {
    given_name: "Alex",
    family_name: "Tester",
    birth_date: "1990-05-14",
    nationality: "FI",
    age_over_18: true,
  },
});

const qrUri = offer.offerQrUri ?? offer.offerUri;
if (!qrUri) throw new Error("The issuer returned no offer URI");
console.log(qrUri);
Run it with your test secret key, and turn the offer into a QR code in your terminal:
pnpm add @authbound/server
# Set AUTHBOUND_SECRET_KEY=sk_test_... in .env
npx qrcode-terminal "$(node --env-file=.env test-id.mjs)"
Scan the QR code with the Authbound wallet and accept the credential. You now have a test ID.
Use made-up details. The test ID is for testing only, and anyone with the offer can collect it, so don’t share the QR code.

What your test ID can verify

A test ID with the details above satisfies these built-in policies:
PolicyWhat it checks
pol_kyc_basic_authbound_v1Name, date of birth and nationality, and that the user is 18 or older
pol_identity_basic_authbound_v1Name and date of birth
pol_age_over_18_authbound_v1That the user is 18 or older, without sharing their birth date
Now go back to your quickstart and scan the verification QR code with the same wallet.

Test with your own credential

If your app will verify a credential that you issue, such as a membership card, issue one to yourself instead:
  1. Create a credential definition and an offer, following Issue credentials.
  2. Scan the offer with the Authbound wallet.
  3. Create a policy that targets your credential definition, as described in Create your own policy, and use its ID in your verification.

If something goes wrong

What you seeWhat to do
The script fails with invalid_key_format or invalid_keyUse a test secret key (sk_test_...) from the project you’re testing. See Errors.
The wallet says the offer has expiredOffers are short-lived. Run the script again for a new one.
Verification fails with policy_not_satisfiedYour test ID is missing a detail the policy asks for. Issue a new one with every claim shown above.
Verification fails with user_declinedThe request was declined in the wallet, or the wallet has no matching test ID. Issue the test ID if you haven’t, then start a new verification and approve it.