Verification method selector (v2)

Allow users to choose their preferred identity verification method

Display a list of identity verification methods to the user. The user will be directed to the verification method of their choice.

note

Looking for the previous version? See Verification method selector (v1).

---

Key features

• User-driven selection: Shows the user a selection page with the available verification methods.
• Category-based routes: Creates output routes based on the category of the selected method (e.g. eIDs, doc-idv), not per individual method.
• Method assets: Each method includes display assets (label, image, optional sublabel).
• Flexible routing: No constraints on the type of step that can be associated with transitions.

---

Configuration

Attribute	Type	Required	Description
methods	array	Yes	Flat list of verification method objects to present to the user. Minimum 1 entry. The Player renders one selectable option per entry, in declaration order.
methods[].method	string	Yes	Method identifier. Accepted values: france_identite, personalausweis, doc_idv, eudi_wallet.
methods[].assuranceLevel	string	No	Per-method assurance level override. Accepted values: low, substantial, high. Falls back to eIds.assuranceLevel for eID methods when not set.
methods[].trustFramework	string	No	Per-method trust framework override. Accepted values: eidas. Falls back to eIds.trustFramework for eID methods when not set.
eIds	object	No	Default assurance configuration applied to all eID methods that do not carry their own assuranceLevel / trustFramework.
eIds.assuranceLevel	string	No	Default assurance level for eID methods. Accepted values: low, substantial, high.
eIds.trustFramework	string	No	Default trust framework for eID methods. Accepted values: eidas.
enableRetry	boolean	No	When true, adds a retry output route that can be used to handle user cancellations. Defaults to false.

Output ports are category-based: one port is created per category derived from the declared methods. The supported categories and their associated methods are:

Port	Methods routed through this port
eIDs	france_identite, personalausweis
doc-idv	doc_idv
eudi_wallet	eudi_wallet

Frontend implications:

Each method is associated with a set of display assets shown in the selection UI:

• A label (the method's title)
• An image displayed within the selection block
• An optional sublabel (e.g. "France" for France Identité, "Germany" for German eID)

---

Example

{
  "eIds": {
    "assuranceLevel": "substantial",
    "trustFramework": "eidas"
  },
  "methods": [
    {
      "method": "france_identite",
      "assuranceLevel": "substantial",
      "trustFramework": "eidas"
    },
    { "method": "personalausweis" },
    { "method": "doc_idv" }
  ]
}

In this example, both france_identite and personalausweis route through the eIDs port to a downstream eIDs step. personalausweis inherits assuranceLevel: "substantial" and trustFramework: "eidas" from the top-level eIds default.

---

Input datablocks

This step does not require any input datablocks.

---

Output datablocks

Data block	Produced on port	Description
eIDMethodSelection	eIDs	Emitted when the user selects an eID method. Carries the selected method and its assurance context.

eIDMethodSelection

Field	Type	Description
method	string	The method key selected by the user (e.g. "france_identite", "personalausweis").
assuranceLevel	string	Resolved assurance level for the selected method (low, substantial, or high). Present when configured.
trustFramework	string	Resolved trust framework for the selected method (e.g. "eidas"). Present when configured.

This datablock is consumed by a downstream eIDs step to determine which provider to call.