New Device Info for App-based 3DS Authentications
Release Date
September 3, 2025
Products Affected
3DS Authentication APIs
Impact
New device data fields added to authentication object
Audience
All customers using Lithic 3DS
Action Required
None, this change is additive only
Overview
Beginning Wednesday, September 3rd, the 3DS Authentication object will expose additional device data fields for app-based authentications.
Previously, device information was only available as a base64-encoded block in the device_info
field. This encoded format made the rich device information available from app-based 3DS authentications unnecessarily difficult to access. With this update, card programs can now access device attributes including platform, device model, operating system details, location data, and screen resolution as separate fields for improved monitoring and analytics.
Details
The app
object within authentication responses for app-based transactions now includes additional device data fields alongside the existing device_info
and ip
fields. These new fields provide structured access to device attributes that were previously only available in encoded format.
Additional App Object Fields
platform
- Device platform (Android, iOS, Windows, etc.)device
- Device manufacturer and model (e.g., "Apple iPhone 16")os
- Operating system details (e.g., "Android 12", "iOS 17.1")locale
- Device locale setting (e.g., "en-US")time_zone
- UTC offset in minutes (range: "-720" to "840")screen_width
- Screen width in pixelsscreen_height
- Screen height in pixelslatitude
- Device location latitude coordinate (-90 to 90)longitude
- Device location longitude coordinate (-180 to 180)
Example Response
Previously, app-based authentication responses only included the encoded device information:
{
"app": {
"device_info": "eyJDMDAxIjoiaU9TIiwiQzAwMiI6ImlQaG9uZTEwLjQiLCJDMDAzIjoiaU9TIi...",
"ip": "198.51.100.42"
}
}
With this update, the same device data is now available as individual fields:
{
"app": {
"device_info": "eyJDMDAxIjoiaU9TIiwiQzAwMiI6ImlQaG9uZTEwLjQiLCJDMDAzIjoiaU9TIi...",
"ip": "198.51.100.42",
"platform": "iOS",
"device": "Apple iPhone 16",
"os": "iOS 17.1",
"locale": "en-US",
"time_zone": "-300",
"screen_width": 1080,
"screen_height": 1920,
"latitude": 37.7749,
"longitude": -122.4194
}
}
Release Timeline
Production availability: September 3, 2025
User Impact
This change is additive only. Existing integrations will continue to function without modification. The original device_info
field remains unchanged.
Updated Documentation
For complete authentication response specifications, visit our API Reference.
If you have any questions or concerns, please contact us via the HELP link in your Lithic Dashboard.
The Lithic changelog has an RSS feed! To monitor for new update announcements, subscribe with your preferred RSS reader.