Learn how hConnect identity verification works with this simple overview.
Test Environment:
  • Use sandbox credentials CLIENT_ID: B6bL0h8G and CLIENT_SECRET: B6bL0h8G for testing.
  • Use https://localhost:3000 as your callback URL.

​
Step 1: Initiate a verification

Redirect your users to the hConnect verification page: 
https://sandbox.verify.hopae.com?client_id=B6bL0h8G&redirect_uri=https://localhost:3000

​
What happens:

  1. User sees a intro page and clicks Continue
  2. User selects their ID Provider (e.g., Smart-ID)
  3. User enters their identifier (Smart-ID test: PNOLT-40504040001)
  4. After verification, user is redirected to your callback URL with an authorization code

​
Step 2: Get Authorization Code

Your callback URL receives the authorization code: 
https://localhost:3000?code={code}

​
Step 3: Exchange Code for User Data

Exchange the authorization code for user information: 
curl -X POST https://sandbox.connect.hopae.com/api/v1/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "authorization_code",
    "code": {code},
    "client_id": "B6bL0h8G",
    "client_secret": "B6bL0h8G"
  }'

​
Step 4: Get Verified User Data

The API returns a JWT token with verified user information: 
{
  "iss": "hopae",
  "aud": "B6bL0h8G",
  "eid": "smartid",
  "provider_id": "PNOLT-40504040001-MOCK-Q",
  "given_name": "OK",
  "family_name": "TESTNUMBER",
  "nationality": "EE",
  "birthdate": "1905-04-04",
  "sub": "7SgS2wuznPKXh01XkgtcUm-htJP6tXvR",
  "iat": 1755761505,
  "exp": 1755765105
}

​
Complete Flow Summary

1

Redirect

Send user to hConnect verification page
2

Verify

User completes identity verification
3

Callback

Receive authorization code at your callback URL
4

Exchange

Trade code for verified user data
✅ That’s it! You now understand the complete hConnect flow.

​
Ready to Integrate?

Data Types

All available user data fields

Integration Guide

Complete integration guide with all options

​
Need Help?

Contact us at dev@hopae.com for production credentials and support.