New Verification

The New Verification page is the linear wizard that opens when you click New Verification anywhere in the portal. It is the only path to creating a verification — keeping the flow linear means every record on the Verifications list has the required attribution, matter, and consent captured up-front.

Anatomy of the page

1. Page header

A simple PageHeader with the title New Verification and a one-line description. The wizard does not put a primary action here — submit lives at the end of the wizard itself, on the Review step.

2. Step rail

The vertical step rail on the left is the StepWizard component. Steps light up as you complete them, and you can jump backwards by clicking any completed step. Forward navigation requires the current step’s gating condition (e.g., a type selected, a matter attached) to be satisfied.

3. Step body

The body changes per step — selectable cards on Subject and Type, a searchable list on Client/Member, a checkbox grid on Steps, an inline matter picker on Matter, a recipient form on Recipients, and a summary on Review.

The seven steps

1. Subject

Choose between Client (external) and Team Member (internal). Switching clears any previously selected client or member.

2. Type / Template

Four cards:

• Default — your organization’s preset; the badge shows the step count and base type
• IDV Template — document + person + biometric_face + attestation
• KYC Template — IDV plus location, contact, PEP/HIO, consent
• Custom — empty step list to build by hand

3. Client / Member

A searchable list of existing clients or team members. For clients you can also create a new one inline (name, email, type, country) without leaving the wizard. Selecting a row pre-fills the subject contact fields on Review.

4. Steps

A grid of every available step. Each row shows:

• A checkbox (disabled if required, e.g., document for IDV/KYC)
• The step label and an estimated duration in minutes
• A price badge (amber border) for paid lookups
• A Required badge for non-removable steps

If your role is Member, paid steps are locked with a tooltip pointing you to an admin. The bottom banner totals the cost of any selected paid lookups.

5. Matter

A required step. The picker reuses the same component as the envelope flow and Athenty Snap, so you can search across open matters or create a new one in place. The wizard refuses to advance until a matter is attached.

6. Recipients

Optional third-party recipients who receive a copy of the verification report on approval. Each recipient has a name, email, and optional organization. Recipients are added or removed inline.

7. Review

A side-by-side summary of every previous decision plus subject contact fields (first/last name, email, phone). Subject contact pre-fills from the chosen client/member but can be overridden — handy when a client’s preferred email differs from the one on file. Overrides do not modify the client record.

Submitting

Clicking Create & Send on the Review step:

1. Creates the verification (initiated status).
2. Delivers the invite via the configured default channel.
3. Transitions the verification to in_progress.
4. Navigates to the verification detail page.

If the request includes paid steps and your tenant has no payment method on file, the API returns 402 and the wizard redirects you to Settings ▸ Billing with a toast.

Unsaved changes guard

If you started filling in the wizard and try to navigate away (browser back, sidebar nav), you are prompted to confirm. Submission via Create & Send bypasses the guard automatically.

Permissions and scope

Role	Can use the wizard	Paid steps
Owner / Admin	Yes	Can toggle freely
Member	Yes	Locked — must ask an admin
Viewer	No (button hidden on the list page)	n/a

Troubleshooting

Symptom	Most likely cause	Fix
Continue button greyed out	Current step’s gating condition not met	Pick a Type / select Steps / pick a Matter — whichever is the current step
Paid step locked with tooltip	Your role is Member	Have an owner/admin toggle paid steps
Submit fails with billing redirect	No card on file but request includes paid steps	Add a card in Settings ▸ Billing and resubmit
Inline client/matter create fails	API validation (duplicate, missing fields)	Read the toast; fall back to selecting an existing record
Wizard reset on tab close	Wizard state is in memory only	Use a draft (start the request and stop on Drafts tab — that persists server-side)

Related pages

• Verifications — list of created verifications
• Settings ▸ Verification Defaults — your org’s default template
• Settings ▸ Billing — payment method for paid steps