Developer Integration Guide
Use this page to integrate your Data Fiduciary application with the Consent Manager Simulation Portal.
1. Create API Key
Login as a Data Fiduciary, open API Key Management, generate a key, and store it securely. The full key is shown only once.
2. Configure Purpose
Create or publish a fiduciary purpose so the portal can render notice text, retention, and field requirements.
3. Launch Consent Request
GET /consent-request.php?api_key=YOUR_KEY&request_uuid=UUID&fiduciary_id=5&purpose_id=12&external_ref=ORDER123&return_url=https://fiduciary.example/callback&ts=...
4. Handle Callback
The return URL receives request UUID, consent status, age category, and parent/guardian consent status.
5. Poll APIs
GET /api/fiduciary-consent-status.php?api_key=YOUR_KEY&request_uuid=UUID
GET /api/child-parent-consent-status.php?api_key=YOUR_KEY&principal_user_id=22&purpose_id=12
Recommended fiduciary-side records
- Portal request UUID
- External transaction reference
- Purpose ID and version
- Returned consent status
- Age category and guardian consent status for child profiles
- Timestamp and callback payload snapshot