Why isn’t ZKPassport working?
If you are having issues with ZKPassport, make sure that you are using the latest version of the app. Each passport may only be used for one successful verification attempt.
If the QR code, app, or ZKPassport verification isn’t working for you, you can complete compliance checks via standard KYC using Predicate.
Click: standard KYC using Predicate.
My passport/ID card is not being recognized. What should I do?
If your passport or ID card isn’t being detected by the app:
Check NFC settings - Ensure your device supports NFC and that it’s turned on in your settings.
Position the document correctly - Place your passport or ID card flat against your device’s NFC reader area (usually near the top or back of the phone). Hold it steady for a few seconds.
Verify document compatibility - If the issue persists, confirm that your document type and issuing country are supported in the ZKPassport Registry Explorer.
Which countries or ID types are supported by ZKPassport?
You can find the ZKPassport Registry Explorer with supported countries here
If your country or Identity Document is not supported, you will need to use Predicate for identity verification.
ZKPassport timed out, can I go through again?
You can try to refresh the page and try again.
If it is still not working, you should use Predicate.
How long until I get verified by ZKPassport?
ZKPassport verification should process in 5 minutes or less.
If it is taking longer than 10 minutes, there may be an error and you should refresh the page and app.
If you are unable to use ZKPassport, use the Predicate option instead.
Is ZKPassport compatible with all browsers?
Yes.
Can I independently verify the proof generated by ZKPassport?
Yes, the proof is in the call data of the transaction, technical users can extract this and verify themselves
Facematch
Private Facematch in ZKPassport compares your live face to the image stored in the chip of your biometric ID.
There are five steps to complete this facematch process:
Look directly at the camera with a neutral expression.
Slowly rotate your face slightly to the left using your neck (make sure you can still see the phone screen). The app will provide on-screen instructions to guide you if you need to adjust your direction.
Repeat the same process while looking up.
Repeat while looking right.
Repeat while looking down.
Reasons Why Private Facematch Might Fail
To ensure that the process is performed correctly and on a trusted device, ZKPassport uses Google Play Integrity on Android and the App Attestation Service on Apple devices.
The ZKPassport mobile app will not generate a Private Facematch Proof if your device is NOT regarded as being highly trustworthy by the services above.
Possible reasons include:
The device is jailbroken or rooted.
The device is running GrapheneOS.
The device’s certificate is listed among the blacklisted certificates maintained by Google
The manufacturer uses a signature scheme that we do not support.
Solana mobile is not currently compatible with facematch