added

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 pixels
  • screen_height - Screen height in pixels
  • latitude - 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.