Testing
You test the European Digital Identity Wallet (EUDI Wallet) on Testbed, https://testbed-eid.scrive.com, with a wallet's sandbox app on your phone. Every test has two steps: you create a transaction with a DCQL query, and you fetch the shared data. This page covers what you need to start testing and the steps for each wallet.
The EUDI Wallet provider (eudiw) is experimental, and you can only use it on Testbed for now. The wallets' sandbox apps are test versions too. While everything is in testing, you may run into bugs, and the API may still change in ways that need changes to your integration.
Credentials
Testing a wallet uses two credentials:
- Your eID Hub test token authenticates your API calls, the same as for every other provider. Request EUDI Wallet test access, and Scrive turns it on for your account. See Authentication.
- Relying party credentials identify who asks the wallet for data. On Testbed, eID Hub always uses Scrive's relying party credentials, so you do not need your own registration or access certificate. You cannot use your own relying party credentials for now. The wallet sees the request as coming from Scrive, because eID Hub sends Scrive's access certificate with it.
Wallet-specific testing
Each wallet has its own sandbox app and test identity, and the wallets run as mobile apps, so you need a phone to test. For each wallet below you find what you need, how to get the app, how to get a test identity, how to run a test and what the results look like.
EU reference wallet
The EU reference wallet is the European Commission's reference implementation of the EUDI Wallet. It is a test wallet, and you issue its PID yourself from the Commission's test issuer, with any person data you like. The app is public, so you only need your eID Hub test access, not app access through Scrive.
What you need
| Setting | Value |
|---|---|
| Ecosystem | internal |
| Test identity | A PID you issue yourself from the EU reference issuer |
| Phone | Android 10 or later. There is no ready-made iOS app |
Get the app
The reference wallet is not in the app stores. On Android, download the APK from the latest release on the app's GitHub releases page and install it. Your phone must allow installing apps from unknown sources. On iOS, there is no prebuilt app. You build it from source with Xcode and your own Apple signing setup, as described in the iOS installation guide. For testing with eID Hub, Android is the quicker option.
When you open the app for the first time, it asks you to set a PIN. You need it every time you share data from the wallet.
Leave Check Registration Certificates in the app's settings off, which is the default. If you turn it on, the wallet can show a warning before you share, and Share stays unavailable until you acknowledge it.
Issue a test PID
- In the app, open the Documents tab, tap + and choose From list. The first time you open the app, it takes you there after you set your PIN.
- Choose PID.
- In the web view, choose Country Selection, then FormEU, and tap Submit.
- Fill in the form with any data. The wallet later shares exactly what you enter here. Use a date of birth more than 18 years ago, so you can also test age checks.
- When the success screen appears, tap Close. The PID is now in the wallet.
Run a test transaction
- Create a transaction with the request in Usage, with
ecosystemset tointernaland a DCQL query that matches the credential type and claim names of the PID you issued. - Open the
accessUrlfrom the response on the phone with the wallet app, and tap Open wallet. - The wallet shows the requested claims and who is asking. Tap Share and enter your wallet PIN.
- The wallet sends you back to the browser, and eID Hub redirects you to your
redirectUrl. The transaction only completes in the browser that opened eID Hub's page, so finish the flow there. - Fetch the transaction and read
walletResponse, as described in Completion data.
To test the cross-device flow, open accessUrl in a browser on your computer instead, and scan the QR code on eID Hub's page with the phone that has the wallet app. Share the data in the wallet as in step 3. eID Hub's page on your computer then redirects to your redirectUrl.
When something does not work
Check that you have the latest release of the app. The Commission only supports the latest version. Known bugs are listed in the app's Android issue tracker. When you report a problem to Scrive, include the transaction ID and the app version.
Read more
- Test with the wallet application on docs.eudi.dev
- EUDI Android wallet on GitHub
- EU reference issuer
d-you (Germany)
d-you is Germany's EUDI Wallet. You test with its sandbox app and a test PID from a simulated ID card.
What you need
| Setting | Value |
|---|---|
| Ecosystem | germany |
Credential type (vct) | urn:eudi:pid:de:1 |
| Credential format | SD-JWT VC (dc+sd-jwt) only |
| Test identity | Simulated ID card in the sandbox app |
Get the sandbox app
Access to the sandbox app is given per email address, and each address must be linked to an Apple or Google account. You can get access in two ways:
- Through Scrive: when you request test access, send us the email addresses of everyone who will test.
- From the German sandbox: join the sandbox yourself, as described in Joining the Ecosystem. Members get access to the sandbox app after their kick-off call.
Then install the app:
- iOS: you get an invitation email from TestFlight. Follow its link to install the app. Set TestFlight to install updates automatically, because updates are frequent and not announced.
- Android: there is no invitation email. Once your address is on the tester list, install the app from Google Play.
Issue a test PID
The sandbox app issues a PID from a simulated ID card, so you do not need a physical card. The simulated card accepts any PIN.
- Open the app and turn on Use simulated eID card.
- Tap Get Started.
- When asked, choose Yes, ID card is available, then Yes, card PIN is set and known.
- The app shows the ID card data that will be shared. Choose Agree and enter any 6-digit PIN as the card PIN.
- On Android, tap the screen when the app asks you to scan the ID card. On iOS, the app continues on its own.
- Set your wallet PIN. You need it every time you share data from the wallet.
Run a test transaction
- Create a transaction with the request in Usage. It already uses Testbed and the
germanyecosystem. - Open the
accessUrlfrom the response on the phone with the sandbox app, and tap Open wallet. - Check the request in the wallet and share the data with your wallet PIN.
- The wallet sends you back to the browser, and eID Hub redirects you to your
redirectUrl. The transaction only completes in the browser that opened eID Hub's page, so finish the flow there. - Fetch the transaction and read
walletResponse, as described in Completion data.
To try the flow without writing code, open the demo app on the phone, enter your test token and choose the EUDI Wallet with the germany ecosystem. The demo app fills in a DCQL query for the German PID.
d-you only supports the same-device flow. Open accessUrl on the phone that has the app. Scanning the QR code (crossDeviceUrl) from another device does not work.
What the test results look like
Text values are in uppercase, for example MUSTERMANN. Special characters are not replaced, so Ö stays Ö and does not become OE. Dates use the format YYYY-MM-DD. Address claims can be missing, even when the person has a registered address.
Each test PID can be shared 10 times. After that, sharing fails until you issue a new PID in the app.
When something does not work
Check that you have the latest version of the app, and test again after each update. When you report a problem to Scrive, include the transaction ID, the app version and the wallet logs. To get the logs, open the app's menu and tap Download Logs. Known bugs of the app are listed in its iOS and Android issue trackers.
Read more
- German EUDI Wallet developer guide
- Wallet use instructions, with the known quirks of the sandbox app
- German PID reference