Put result checking directly on your school website.
Students stay inside the school’s familiar website while iCademia securely handles PIN verification, result retrieval and ongoing widget updates.
Secure isolation
Credentials never enter the school website.
School branded
Match colour and verified school identity.
Framework neutral
Works anywhere a secure iframe is allowed.
Maintained centrally
Improvements arrive without code changes.
Quick start
One secure embed, any website stack.
- 1Register and verify the school on iCademia.
- 2Send us the production website domains for allowlisting.
- 3Copy the School Registry ID from the administrator dashboard.
- 4Choose the school colour and paste the relevant example.
- 5Test with an issued card before publishing the page.
<iframe
src="https://www.icademia.app/widget/result-checker?school=ICA-SCH-SDM-OWE&colour=%233730A3"
title="School result checker"
width="100%"
height="620"
loading="lazy"
allow="clipboard-write"
style="border:0;border-radius:20px;max-width:560px"
></iframe>What we need from the school
A short activation checklist.
Verified school administrator and official school email
Production and staging website domain names
School logo, display name and primary brand colour
Technical contact responsible for the website
Privacy-policy and student-data contact
Expected student volume and desired launch date
Security boundaries
The school website never receives PIN values, passwords or raw result data. The embedded checker remains on the iCademia origin.
Production embeds can be restricted to approved domains. Result requests remain rate-limited, audited and protected by the PIN plus registration number.
Never place database credentials or private API keys in browser code. Schools needing server-to-server access must complete a separate integration review.
Technical Reference
Widget Parameters API
The iCademia result checker widget is controlled entirely via URL query parameters passed to the iframe src. No complex API keys or server-side tokens are required for standard integration.
| Parameter | Type | Required | Description |
|---|---|---|---|
| school | string | Required | Your unique School Registry ID (for example, ICA-SCH-SDM-OWE). It determines the logo and school name displayed. |
| colour | hex string | Optional | A six-digit hex color code (e.g., %233730A3). Overrides the default brand color for the widget's primary buttons and accents. |
| compact | boolean | Optional | Set to true to render a tighter vertical UI layout. Ideal for mobile or highly constrained website containers. |
Developer FAQ
Integration questions, answered.
Need a reviewed integration?
Send your domain, School Registry ID and technology stack to the iCademia integration team.