Logo

Fayda

Integration Documentation

Fayda Integration Documentation

Complete guide for integrating with Fayda using eSignet OIDC

Complete Integration Documentation

Access the full technical documentation with code examples in Node.js and Python, detailed flow diagrams, and reference implementations on GitHub.

Try It Yourself

Walk through the Verifayda 2.0 eSignet OIDC flow the way a user would see it, or grab pre-registered credentials for sandbox testing.

Playgroundno requests leave your browser
https://yourapp.com/
Your Apprelying party demo

Welcome to Your App

This is a stand-in for a partner application. Clicking below starts the same redirect a real integration would send to eSignet.

Everything above runs locally in your browser no requests are sent to eSignet or Fayda, and no real Fayda ID is involved. The endpoint URLs and request shapes are the real VeriFayda 2.0 eSignet ones, and the client assertion / token / userinfo JWTs are genuinely RSA-signed and verified with jose in your browser (paste one into jwt.io); the screens themselves are simulated for developer orientation, not the actual eSignet UI. To test against the real eSignet sandbox with your own registered credentials, use the oidc-test-app reference implementation locally. Use the below test credentials and test FANs to test it yourself locally.

Live Sandbox

Sandbox Testing Credentials

Pre-registered client credentials, endpoints, keys, and test personas to copy directly into your test environment.

Primary Test FIN/FAN
3126894653473958
Secondary Test FIN/FAN
6230247319356120
Default Test OTP
111111
Test Client 1 (Port 3000)(http://localhost:3000/callback)
# Configuration for Test Client 1 (Port 3000)
CLIENT_ID=aQ7xN2kLm9_Vp4RzT8cY-hW3sJ6FdE0uXbKqP1
REDIRECT_URI=http://localhost:3000/callback
AUTHORIZATION_ENDPOINT=https://esignet.ida.fayda.et/authorize
TOKEN_ENDPOINT=https://esignet.ida.fayda.et/v1/esignet/oauth/v2/token
USERINFO_ENDPOINT=https://esignet.ida.fayda.et/v1/esignet/oidc/userinfo
EXPIRATION_TIME=15
ALGORITHM=RS256
CLIENT_ASSERTION_TYPE=urn:ietf:params:oauth:client-assertion-type:jwt-bearer
PRIVATE_KEY=ewogICJrdHkiOiAiUlNBIiwKICAia2lkIjogImVmNjk3ZTQ5LTk2M2YtNDQxNy1iZjIxLThiMDZiY2NiY2VjYyIsCiAgImQiOiAi...
Private key is base64 RSA JWK