Device Fingerprint API — Developer Compliance Guide
Effective Date: May 19, 2026 Document Version: May 2026 Legally Binding Original Language: English
This guide is for B2B integrators using the PaperOffice Device Fingerprint / Device Intelligence API. It does not replace legal advice. The English version is binding.
1. Role Allocation (Default)
| Party | GDPR Role | Responsibility |
|---|---|---|
| Customer (integrator) | Controller | Lawful basis, end-user notices, data subject rights, records of processing |
| PaperOffice | Processor | Processing on documented instructions via API; tenant isolation; technical deletion on POST /privacy/forget |
PaperOffice does not provide consent banners or per-call legal-basis validation. Maximum API features remain available; compliance obligations stay with Customer as Controller.
2. Integration Checklist
Before production use, Customer should confirm:
- Lawful basis documented (e.g. Art. 6(1)(f) GDPR legitimate interest where applicable — Customer decides).
- Privacy notice updated to describe device fingerprinting, purposes (fraud prevention, authentication, abuse detection), and retention.
- DPA generated and accepted via the in-platform Compliance Package.
- Bearer authentication — all data endpoints require a valid account context.
- Tenant scope — fingerprint data is isolated per workspace (root account) by default.
- Retention — default 90 days; configurable up to 365 days per account settings.
- Art. 17 delegation — implement
POST /privacy/forgetwhen erasure is required. - Network Intelligence — cross-tenant
network_pool=trueonly after separate contractual approval (legal@paperoffice.ai). - No raw signal storage expectation — PaperOffice stores hashes and metadata, not raw canvas/audio payloads in the database.
- Sub-processors — review the public Sub-Processor List and generated Compliance Package.
3. Key API Endpoints
| Endpoint | Method | Purpose |
|---|---|---|
/fingerprint/identify | POST | Register or update device signals (tenant-scoped) |
/fingerprint/verify | POST | Verify visitor against stored signals |
/fingerprint/device/{visitorId} | GET | Retrieve device metadata |
/privacy/forget | POST | Art. 17 erasure delegation (tombstone + delete) |
/privacy/network_intelligence | GET | Addon approval status |
/fingerprint/similar | GET | Similar devices (tenant-scoped; network_pool gated) |
Each identify response includes a compliance object with data_categories, tenant_scope, retention_default_days, and customer_responsibility_notice.
4. Art. 17 Forget (Example)
``bash curl -X POST https://api.paperoffice.ai/latest/privacy/forget \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"visitor_id": "VISITOR_ID_HERE"}' ``
Re-ingestion of forgotten identifiers is blocked (IDENTIFIER_FORGOTTEN).
5. Privacy Notice Snippet (Template for Customer)
> Where we use device fingerprinting through PaperOffice AI, we process technical device and network characteristics (such as browser signals, hashed canvas/WebGL fingerprints, IP-derived metadata, and fraud-prevention scores) to secure our services, prevent abuse, and detect fraud. PaperOffice Enterprise Operations, S.L.U. acts as our processor under Article 28 GDPR. Data is processed in the EU. Default retention is 90 days unless we configure a shorter or longer period (maximum 365 days). You may exercise your rights under applicable data protection law by contacting us at [CUSTOMER CONTACT]. We will instruct our processor to delete relevant fingerprint records where required.
Customer must adapt this text to its jurisdiction and legal basis.
6. Network Intelligence
The optional Network Intelligence addon enables cross-tenant similarity pools when network_pool=true is set and the addon is approved for the account. Without approval, pool requests return 403 NETWORK_INTELLIGENCE_NOT_ENABLED.
Customer must ensure end-user disclosure where required before enabling cross-tenant features.
7. Related Documents
- Sub-Processor List
- TOM Reference
- DPA Reference
- Postman:
https://api.paperoffice.ai/latest/docs/postman
Last updated: May 19, 2026
© 2002–2026 PaperOffice Enterprise Operations, S.L.U. All rights reserved.