Electronic Id

Users can use the following electronic ID cards to prove their age:

• Swedish Bank ID (Sweden)
• FTN (Finland)
• MitID (Denmark)
• Bank ID (Prague) - only available without UI
• Moje ID (Prague)- only available without UI
• EDO App (Poland)- only available without UI

If you are looking to perform age checks in any of these countries, we recommend offering these methods as an option to users. These eID schemes are widely adopted and regularly used, and therefore should lead to high success rates.

Electronic ID Enhanced also supports Polish MojeID, Polish ID, Czech Bank ID and Czech MojeID. With this method, accuracy is increased further as the individual’s information can be matched to purchase data records. The individual’s date of birth and address are shared with the client with this option.

This way of proving age has high accuracy, as the digital IDs have already been verified by a third-party supplier.

This method is good for:

• High assurance
• Regional

The user will be redirected to the relevant flow, where they will be asked to share information from their eID scheme with Yoti in order to verify their age.

Example payload

This is to enable:

• Swedish Bank ID (Sweden)
• FTN (Finland)
• MitID (Denmark)

{

    "type": "OVER",

    "electronic_id": {

      "allowed": true,

      "threshold": 18,

      "sub_methods": [

        "MIT_ID",

        "SWEDISH_BANK_ID",

        "FTN" 

      ]

    }

    "ttl": 900,

    "reference_id": "over_18_example",

    "callback": {

       "auto": true,

       "url": "https://www.yoti.com"

    },

    "notification_url": "https://yourdomain.example/webhook",

    "cancel_url": "https://www.yoti.com"

}

##

Launch URL

The second step in the integration process is to simply launch the url that is retrieved in the API call detailed above. The user will be directed to the relevant electronic Id method, where they will be able to complete the verification process. On completion, the user will be redirected to the "return_url" that was configured in the API call detailed above.

Retrieve Results

The final step in the integration would be to retrieve the results of the age verification. To do this, a final call to our API will need to be made.

GET https://age.yoti.com/api/v1/electronic-id/status/{conversationId}

The conversion ID that is returned in the API call to request a session must also be used as a query parameter in this API call.

Example Response

{

  "status": "COMPLETE",

  "data": {

    "fullname": "string",

    "address": "string",

    "date_of_birth": "string"

  }

}