UDF SDK Documentation

Universal Device Financing — Device Enrollment SDK

v1.0.0Stable

Android SDK

Kotlin/Java library with Device Owner API, SafetyNet attestation, FCM push, and offline lock enforcement.

iOS SDK

Swift framework with Secure Enclave key storage, Apple DeviceCheck/App Attest, APNs push, and MDM profiles.

REST API

Platform-agnostic HTTP endpoints for custom integrations, IoT devices, Windows, macOS, and Smart TVs.

Enrollment Flow
1

Issue Token

Admin/merchant issues a time-limited enrollment token from the portal.

2

Register Device

SDK sends device serial, IMEI, platform, and OS version.

3

Bind Certificate

Device generates RSA-2048 key pair; public key is bound to the device record.

4

Register Push Token

FCM (Android) or APNs (iOS) token registered for real-time commands.

5

Complete Enrollment

Initial compliance report submitted; device activated and ready.

Runtime Operations

Heartbeat (every 5 min)

Liveness ping with GPS, battery, and compliance score.

Push Commands

FCM/APNs real-time delivery of lock, unlock, wipe, restrict.

Command Polling (fallback)

HTTP polling every 60s when push is unavailable.

Compliance Reports (hourly)

Root detection, tamper flags, encryption status, geo-location.

Offline Lock Enforcement

Device auto-locks after 72h without server contact.

API Base URL & Authentication

Base URL

text
https://your-platform.manus.space/api/sdk/v1

Authentication Header

text
X-UDF-API-Key: udf_your_tenant_api_key

Obtaining your API Key

Navigate to API Keys in the admin dashboard, select your tenant, and create a new key with device:enroll, device:heartbeat, and command:receive scopes.