Use ‘Update my personal details’ in Your Service

By Nicolas Rialas, Lead Developer

You can now integrate the ‘Update My Personal Details‘ service into your digital service to fetch or update a user’s email, mobile number, and correspondence address, without breaking the user journey.

How to Integrate

1. Call the Civil Registry API
   Retrieve the logged-in user’s contact details.
2. Check if contact info is available
   • If missing: Notify the user and redirect them to ‘Update my personal details’.
   • If available: Display the data and offer an option to update it.

In both cases, clicking to update will take the user to ‘Update my personal details’.

If the API doesn’t return contact information, you must inform the user that they’ll be redirected to the Update My Personal Details service. You can use a message or screen like the one shown below.

Greek

English

If the API returns contact information, you can display it in a form like the example below.

Greek

English

If the user selects the second option to change their contact details, redirect them to the Update My Details service.

To link to ‘Update my personal details’, use:

Staging URL:

https://update-my-details.staging.service.gov.cy/ReturnUrl/SetReturnUrl?Url={base64EncodedString}&UserProfileId={base64EncodedString}&lang={en}

Production URL:

https://update-my-details.service.gov.cy/ReturnUrl/SetReturnUrl?Url={base64EncodedString}&UserProfileId={base64EncodedString}&lang={en}

• URL: Base64-encoded return URL to bring the user back after submission or cancellation
• UserProfileId: Base64-encoded user profile ID (the sub claim from cyLogin) of the logged-in user
• lang: Optional. Use lang=en for English. Omit for Greek.

Purpose	Plain Value	Base64 Encoded
Return URL	https://mytest-service.gov.cy	aHR0cHM6Ly9teXRlc3Qtc2VydmljZS5nb3YuY3k=
User Profile ID	UserProfileId=0000001909285501	MDAwMDAwMTkwOTI4NTUwMQ

• Language can’t be changed within ‘Update my personal details’. Set it before redirecting.
• Logout isn’t allowed within ‘Update my personal details’. Your service manages the session and logout.
• The ‘Update my personal details’ service can be used by Cypriot citizens over the age of 18.
• Always redirect from an authenticated session (not anonymous).
• The ‘Update my personal details’ uses Unified Design System Version 3.x.x
• Redirection only works from services hosted on “.gov.cy” domains.

---

Need help?
Contact us at dsf-admin@dits.dmrid.gov.cy

---

Relevant Content

• Designing accessible online services: a heuristic approach for designers
• 13 overlooked details in Front-end Development (That make a big difference)
• How User Research drives success in digital Government services
• Enhancing the Unified Design System with automated visual testing
• Design System update (V.3.0.0) - Unified Design System