Method selector for verifying ID (v2)

Stable / GA

This is the current stable version of this step type.

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.

---

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

Option	Type	Required	Default	Description
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.
methods	object[]	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. eID methods: franceIdentite, personalausweis, lIdentiteNumeriqueLaPoste, spid, itsme, lithuanianMobileId, mojeIdPl, idin, smartId, mitId, norwegianBankId, estonianIdCard, latvianIdCard, lithuanianIdCard, finnishTrustNetwork, frejaEid, belgiumIdCard, edoApp, eParakstsMobile, portugueseIdCard, finnishHenkilokortti, serbianIdCard, swedishBankId, idAustria, chaveMovelDigital, oneId. Document IDV: doc_idv. EUDI wallet: eudi_wallet. Accepted values: franceIdentite, personalausweis, lIdentiteNumeriqueLaPoste, spid, itsme, lithuanianMobileId, mojeIdPl, idin, smartId, mitId, norwegianBankId, estonianIdCard, latvianIdCard, lithuanianIdCard, finnishTrustNetwork, frejaEid, belgiumIdCard, edoApp, eParakstsMobile, portugueseIdCard, finnishHenkilokortti, serbianIdCard, swedishBankId, idAustria, chaveMovelDigital, oneId, doc_idv, eudi_wallet.
methods[].assuranceLevel	string	No	—	Per-method assurance level override. Falls back to eIds.assuranceLevel for eID methods when not set. Accepted values: low, substantial, high.
methods[].trustFramework	string	No	—	Per-method trust framework override. Falls back to eIds.trustFramework for eID methods when not set. Accepted values: eidas.
enableRetry	boolean	No	false	When true, adds a retry output route that can be used to handle user cancellations.

Example configuration

{
  "methods": [
    { "method": "personalausweis" },
    { "method": "franceIdentite" },
    { "method": "doc_idv" }
  ],
  "eIds": {
    "assuranceLevel": "high",
    "trustFramework": "eidas"
  }
}

---

Input data blocks

This step does not consume any input data blocks.

---

Routes

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

Route	Methods routed through this route
eIDs	franceIdentite, personalausweis, lIdentiteNumeriqueLaPoste, spid, itsme, lithuanianMobileId, mojeIdPl, idin, smartId, mitId, norwegianBankId, estonianIdCard, latvianIdCard, lithuanianIdCard, finnishTrustNetwork, frejaEid, belgiumIdCard, edoApp, eParakstsMobile, portugueseIdCard, finnishHenkilokortti, serbianIdCard, swedishBankId, idAustria, chaveMovelDigital, oneId
doc-idv	doc_idv
eudi_wallet	eudi_wallet
retry	Only available when enableRetry is true. Activated when the user cancels the selection flow, allowing the flow to redirect back to the selection step rather than triggering a session abort.

Example

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

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

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 Personalausweis)

info

Sublabels are only displayed when the set of currently shown methods contains more than one distinct sublabel value. If all displayed methods share the same sublabel, or only one has a sublabel, no sublabels are rendered at all.

tip

Customising labels and sublabels Method labels and sublabels can be overridden per flow version using the Translation manager. Open the Translation manager for your flow version, download the CSV, edit the relevant label or sublabel entries, and upload the modified file.

---

Output data blocks

Data block	Produced on route	Description
eIDMethodSelection	eIDs	Emitted when the user selects an eID method. Carries the selected method and its assurance context. See the full schema for accepted values.

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

---