OIDC API
OIDC overview
Hosted identification at oauth.pasby.africa with PKCE for web applications.
The pasby OIDC API lets third-party apps verify users and receive consented identity attributes through a short, OAuth-like flow:
- Your backend starts a session (
kipindi/login) - The user identifies on pasby’s hosted UI (
national.eid.pasby.africa) - Your backend exchanges the handshake for an access token (
kupeana/shake) - Your backend fetches claims (
resource)
Base URL: https://oauth.pasby.africa/api/v1/oidc/
| Related surface | URL |
|---|---|
| Identification UI | https://national.eid.pasby.africa |
| Developer console | https://console.pasby.africa |
Use OIDC for browser-first products. Use the public API v2 for signing, documents, wildcard QR, and mobile-native flows.
Official SDKs
Prefer an SDK over raw HTTP — they handle PKCE, headers, encryption, and callback wiring.
| Package | Stack | Guide |
|---|---|---|
@finsel-dgi/pasby-next | Next.js App Router | Next.js OIDC |
@finsel-dgi/pasby-react | React + Node backend | React OIDC |
| REST / Go / other | Any HTTP client | OIDC quickstart |
Start here: OIDC quickstart
Navigation labels
| User-facing | Route aliases |
|---|---|
| Start session | kipindi, login |
| Exchange token | kupeana, shake |
| Get user claims | resource |