PCI Watch

Tracking changes across the Payment Card Industry

EMV® 3-D Secure SDK—Device Information

v2.1.0 Specifications

EMV<sup>®</sup> 3-D Secure SDK—Device Information Version 2.1.0 October 2017

countries. EMV<sup>®</sup> 3-D Secure SDK - Device Information v2.1.0

Legal Notice

The EMV<sup>®</sup> Specifications are provided "AS IS" without warranties of any kind, and EMVCo neither assumes nor accepts any liability for any errors or omissions contained in these Specifications. EMVCO DISCLAIMS ALL REPRESENTATIONS AND WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NONINFRINGEMENT, AS TO THESE SPECIFICATIONS. EMVCo makes no representations or warranties with respect to intellectual property rights of any third parties in or in relation to the Specifications. EMVCo undertakes no responsibility to determine whether any implementation of the EMV<sup>®</sup> Specifications may violate, infringe, or otherwise exercise the patent, copyright, trademark, trade secret, know-how, or other intellectual property rights of third parties, and thus any person who implements any part of the EMV<sup>®</sup> Specifications should consult an intellectual property attorney before any such implementation. Without limiting the foregoing, the Specifications may provide for the use of public key encryption and other technology, which may be the subject matter of patents in several countries. Any party seeking to implement these Specifications is solely responsible for determining whether its activities require a license to any such technology, including for patents on public key encryption technology. EMVCo shall not be liable under any theory for any party’s infringement of any intellectual property rights in connection with the EMV<sup>®</sup> Specifications.

countries. EMV<sup>®</sup> 3-D Secure SDK - Device Information v2.1.0 Revision Log—Version 2.1.0 Revision Log—Version 2.1.0

/ v The following changes have been made to the document since the publication of Version 2.0.0.

  • Updated Chapter 1 as follows:
  • Updated the EMV 3DS Protocol Specification version number to 2.1.0.
  • Removed the Definitions table and added a reference to the Definitions table present in EMV 3DS Protocol Specification.
  • Added the Data Version Number section.
  • Added the Supporting Documentation section.
  • Updated Chapter 2 as follows:
  • Data version for the current set of device parameters changed to 1.1
  • Renamed Windows Phone to Windows 10 Mobile.
  • Removed the following Android device parameters: − BluetoothAdapter − Timezone
  • Identifier of Android parameters re-ordered due to the removal of above parameters
  • Updated the description of Android parameters A127, A128, and A130.
  • Moved the Android isSafeMode parameter to the Package Manager group. countries. EMV<sup>®</sup> 3-D Secure SDK - Device Information v2.1.0 Contents Contents 1. 1. 1. 1. 1. 1. 1. 2. 2. 2. 2. 2. 2. 2. 2. 2. countries. EMV<sup>®</sup> 3-D Secure SDK - Device Information v2.1.0 Tables Tables Page v / v Table 1.1: Table 1.2: Table 2.1: Table 2.2: Table 2.3: Table 2.4: Table 2.5: Table 2.6: Table 2. countries. EMV<sup>®</sup> 3-D Secure SDK - Device Information v2.1.0 / v countries. EMV 3-D Secure SDK - Device Information v2.1.0 Purpose / 39 1

Introduction

The 3-D Secure protocol is aimed at securing authentication in browser-based and mobile app-based transactions. The EMV 3-D Secure Protocol and Core Functions Specification version 2.1.0 describes the 3-D Secure protocol and core functions. The 3DS Mobile SDK is the mobile-device-side component of 3-D Secure. The EMV 3-D Secure SDK Specification version 2.1.0 describes the specification for the 3DS SDK. Device identification is used to uniquely identify mobile devices in the 3-D Secure ecosystem. The ThreeDS2Service interface is one of the code elements that are described in the EMV 3-D Secure SDK Specification version 2.1.0. The initialize method of this interface collects the information required for device identification. This information is then sent to the 3DS Requestor App in JSON format. The 3DS Requestor App passes this information to the 3DS Server. The 3DS Server uses this information to create an AReq. 1.1

Purpose

This document describes the device identification parameters that shall be collected by the 3DS SDK. For purposes of this document, when the phrase 3-D Secure, and/or 3DS is utilised, the intent is EMV 3-D Secure.

1.2 Audience This document is intended for use by implementers of the 3DS SDK. 1.3

Definitions

For the definition of the terms used in this document, refer to Table 1.3: Definitions in the EMV 3-D Secure Protocol and Core Functions Specification.

1.4 Abbreviations The abbreviations listed in Table 1.1 are used in this specification. Abbreviation 3DS 3DS SDK Table 1.1: Abbreviations

Description

Three Domain Secure Three Domain Secure Software Development Kit

countries. EMV 3-D Secure SDK - Device Information v2.1.0 Data Version Number Abbreviation ACS AReq ARes DD DPNA DV SDK SW Description Access Control Server Authentication Request Authentication Response Device Data Device Parameter Not Available Data version Software Development Kit Security Warning

/ 39 1.5 Data Version Number The following table provides the Data Version Number status for the 3-D Secure protocol version. Data Version Number 1.0 1.1 Table 1.2: Data Version Numbers Protocol Version Status 2.0.0 2.1.0 Deprecated Active 1.6 Supporting Documentation The following documents are specific to the EMV 3-D Secure protocol and should be used in conjunction with this specification. These documents as well as EMV 3-D Secure FAQs are located on the EMVCo website under the 3-D Secure heading.

  • EMV 3-D Secure— Protocol and Core Functions Specification
  • EMV 3-D Secure SDK Technical Guide
  • EMV 3-D Secure—SDK Specification
  • EMV 3-D Secure JSON Message Samples countries. EMV 3-D Secure SDK - Device Information v2.1.0 Terminology and Conventions / 39 1.7 Terminology and Conventions The following words are used often in this specification and have a specific meaning: Shall Defines a product or system capability which is mandatory. May Defines a product or system capability which is optional or a statement which is informative only and is out of scope for this specification. Should Defines a product or system capability which is recommended. countries. EMV 3-D Secure SDK - Device Information v2.1.0 Data Version / 39 2 Device Identification Parameters This chapter describes the device identification parameters that shall be collected by the 3DS SDK from all mobile platforms. These parameters are categorized as device-platform-specific parameters and parameters that are common to all device platforms. Note: The 3DS SDK shall collect and pass the common parameters. This is the minimum requirement. In addition, the implementer shall ensure that the 3DS SDK collects as many device-platform-specific parameters as possible. The availability of a higher number of device parameters improves the effectiveness of risk-based decision making by the ACS. This, in turn, increases the probability of applying a frictionless flow.

2.1 Data Version The data version specifies the set of device identification parameters that the 3DS SDK shall collect. The data version is a means for participating 3DS 2.0 components to know which set of device identification parameters is being transferred. The data version may change when, for example, there are parameter changes in future mobile OS versions, an existing parameter is deprecated, and so on. The Data Version shall be included in the device identification information that is sent by the 3DS SDK. The device identification parameters that are described in this document constitute Data Version 1.1.

2.2 Minimum Supported Platform Versions Table 2.1 lists the minimum platform versions that shall be supported by the SDK. Table 2.1: Minimum Supported Platform Version Android Platform Minimum Version KitKat 4.4 (API version 19) iOS 8 Windows 10 Mobile 10 2.3 Platform Permissions for Parameters The following types of permissions are required for collecting device identification parameters:

  • No permissions required: Indicates that the device parameters can be directly collected by the 3DS SDK, without any user approval or system permissions. countries. EMV 3-D Secure SDK - Device Information v2.1.0 Common Device Identification Parameters Available in All Platforms / 39
  • Installation-time permissions: Indicates that the device parameters require system permissions to be granted to the app during installation time.
  • Run-time permissions: Indicates that the device parameters can be collected by the 3DS SDK only if the required permissions have already been granted to the app through user approval at run time. The 3DS SDK shall check whether installation-time or run-time permission for a particular parameter is available or has already been granted to the app. If the permission for a particular parameter is not available, then the 3DS SDK shall send one of the reason codes stated in Table 2.6 as the value for the parameter within the Device Parameter Not Available (DPNA) tag. Note: The 3DS SDK shall never prompt the user for run-time permissions. Similarly, the 3DS SDK shall not mandate the inclusion of additional installation-time permissions on the 3DS Requestor App.

2.4 Common Device Identification Parameters Available in All Platforms In addition to the platform-specific device parameters discussed later in this document, Table 2.2 lists the device parameters that shall be collected from all mobile platforms for Device ID validation and risk analysis. The availability of these parameters is subject to change in future OS versions. Note: Each parameter listed in this table shall be collected by the SDK unless the parameter cannot be collected for any of the reasons stated in Table 2.6. Table 2.2: Common Parameters Available in Android, iOS and Windows 10 Mobile Platforms Identifier Parameter C001 Platform Description Platform that the device is using. For example, Android, iOS, Windows 10 Mobile. Permissions Not applicable. C002 Device Model Mobile device manufacturer and model. For example, In Android, Build.Model returns the model name. No permissions required.

countries. EMV 3-D Secure SDK

  • Device Information v2.1.0 Common Device Identification Parameters Available in All Platforms / 39 Identifier Parameter C003 OS Name Description Operating system name. For example, in iOS, the systemName property of the UIDevice class returns the name of the operating system. Permissions No permissions required. C004 OS Version Operating system version. No permissions required. For example, in iOS, the systemVersion property of the UIDevice class returns the version of the operating system. C005 Locale Device locale set by the user. No permissions required. For example, in Windows 10 Mobile, the CurrentCulture property of the CultureInfo class returns the locale. C006 Time zone Device time zone. No permissions required. For example, in Android, the TimeZone.getDefault() method returns a time zone based on the time zone where the program is running. C007 Advertising Unique ID available for advertising ID and fraud detection purposes. No permissions required. For example, in Windows 10 Mobile, AdvertisingManager.Adverti singId retrieves a unique ID used to provide more relevant advertising. C008 Screen Resolution Pixel width and pixel height, i.e., 1080x1920. No permissions required. For example, in Android, the screen resolution can be obtained from the heightPixels and widthPixels fields of the DisplayMetrics class. countries. EMV 3-D Secure SDK
  • Device Information v2.1.0 Common Device Identification Parameters Available in All Platforms / 39 Identifier C009 Parameter Description Device Name User-assigned device name. For example, in iOS, the localizedModel property of the UIDevice class returns the Device Name. Permissions On Android, this parameter requires Bluetooth permission during installation. No permissions required on iOS or Windows 10 Mobile. C010 IP Address IP address of device. On Android, this parameter requires the following permissions during installation. android.permission.INTERNET android.permission.ACCESS_NETWORK_ST ATE No permissions required on iOS or Windows 10 Mobile. C011 Latitude Device physical location latitude. Run-time permissions required on Android API 23 and later, iOS and Windows 10 Mobile. Installation-time permissions required on Android 22 and earlier. C012 Longitude Device physical location longitude. Run-time permissions required on Android API 23 and later, iOS and Windows 10 Mobile. Installation-time permissions required on Android 22 and earlier. countries. EMV 3-D Secure SDK
  • Device Information v2.1.0 Android-Specific Device Parameters / 39 2.5 Android-Specific Device Parameters Table 2.3 provides information about the device parameters that shall be collected by the 3DS SDK from the Android mobile platform for risk analysis by the ACS. In this table, the Group or Identifier column contains the name of the parameter group or parameter identifier. Group or Identifier Telephon y Manager Table 2.3: Android-Specific Device Parameters Element Description Comments Permissions Telephony Manager provides access to information about the telephony services on the device. This group of parameters requires the following permissions: android.permission. SEND_SMS android.permission. READ_PHONE_STATE Run-time permissions A001 A002 A003 A004 User approval is not required for API 22 and earlier because these permissions are granted during installation. DeviceId Unique identifier of the device. For example, IMEI for GSM phones and MEID or ESN for CDMA phones. Run-time permissions SubscriberI d Unique subscriber ID. For example, IMSI for GSM phones. Run-time permissions IMEI/SV IMEI software version. Run-time permissions Group Identifier Level1 Group identifier level 1 for a GSM phone. Available only for API 18 or higher. Run-time permissions countries. EMV 3-D Secure SDK
  • Device Information v2.1.0 Android-Specific Device Parameters / 39 Group or Identifier Element A005 Line1 Number Description Phone number string for line 1. For example, the MSISDN for a GSM phone. Comments Permissions Run-time permissions A006 MmsUAProfUr MMS user agent l profile URL. Available only for API 19 or higher. Run-time permissions A007 MmsUserAgen MMS user agent. t Available only for API 19 or higher. Run-time permissions A008 NetworkCoun tryIso ISO country code equivalent of the current registered operator's MCC (Mobile Country Code). Run-time permissions A009 NetworkOper ator Numeric name (mobile country code + mobile network code) of the current registered operator. Run-time permissions A010 NetworkOper Alphabetic name of atorName the current registered operator. Run-time permissions A011 NetworkType NETWORK_TYPE_xx xx for the current data connection. Run-time permissions A012 PhoneCount Number of phones available. Returns 1 for single standby mode (single SIM functionality). Returns 2 for dual standby mode (dual SIM functionality). Available only for API 23 or higher. Run-time permissions countries. EMV 3-D Secure SDK
  • Device Information v2.1.0 Android-Specific Device Parameters / 39 Group or Identifier Element A013 PhoneType Description Constant that indicates the device phone type. This indicates the type of radio used to transmit voice calls. Comments Permissions Run-time permissions A014 SimCountryI so ISO country code equivalent for the SIM provider's country code. Run-time permissions A015 SimOperator MCC+MNC (mobile country code + mobile network code) of the SIM provider. Run-time permissions A016 SimOperator Service Provider Name Name (SPN). Run-time permissions A017 SimSerialNu Serial number of the mber SIM, if applicable. Run-time permissions A018 SimState Constant that indicates the state of the default SIM card. Run-time permissions A019 VoiceMailAl Alphabetic identifier phaTag associated with the voice mail number. Run-time permissions A020 VoiceMailNu Voice mail number. mber Run-time permissions A021 hasIccCard Returns true if an ICC card is present. Run-time permissions A022 isHearingAi dCompatibil itySupporte d Indicates whether the phone supports hearing aid compatibility. Available only for API 23 or higher. Run-time permissions countries. EMV 3-D Secure SDK
  • Device Information v2.1.0 Android-Specific Device Parameters / 39 Group or Identifier A023 Element Description isNetworkRo aming Determines if the device is considered roaming on the current network, for GSM purposes. Comments Permissions Run-time permissions A024 isSmsCapabl e Determines if the current device supports SMS service. Available only for API 21 or higher. Run-time permissions A025 isTtyModeSu Determines whether pported the phone supports TTY mode. Available only for API 23 or higher. Run-time permissions A026 isVoiceCapa Determines if the ble current device is "voice capable". Available only for API 22 or higher. Run-time permissions A027 isWorldPhon Determines whether e the device is a world phone. Available only for API 23 or higher. Run-time permissions WifiMana ger WifiManager provides the primary API for managing all aspects of Wi-Fi connectivity. This group of parameters requires the following permission: android.permission. ACCESS_WIFI_STATE Installationtime permissions A028 Wifi
  • Mac Address Returns the wireless MAC address of the device. Installationtime permissions A029 BSSID Returns the basic service set identifier (BSSID) of the current access point. Installationtime permissions A030 SSID Returns the service set identifier (SSID) of the current 802.11 network. Installationtime permissions countries. EMV 3-D Secure SDK
  • Device Information v2.1.0 Android-Specific Device Parameters / 39 Group or Identifier Element A031 Network ID Description Each configured network has a unique small integer ID, used to identify the network when performing operations on the supplicant. Comments Permissions Installationtime permissions A032 is5GHzBandS Determines if this upported adapter supports the 5 GHz band. Available only for API 21 or higher. Installationtime permissions A033 isDeviceToA Determines if this pRttSupport adapter supports ed Device-to-AP RTT. Available only for API 21 or higher. Installationtime permissions A034 isEnhancedP owerReporti ngSupported Determines if this adapter supports advanced power and performance counters. Available only for API 21 or higher. Installationtime permissions A035 isP2pSuppor Determines if this ted adapter supports WifiP2pManager. Available only for API 21 or higher. Installationtime permissions A036 isPreferred NetworkOffl oadSupporte d Determines if this adapter supports offloaded connectivity scan. Available only for API 21 or higher. Installationtime permissions A037 isScanAlway Determines if sAvailable scanning is always available. Available only for API 18 or higher. Installationtime permissions A038 isTdlsSuppo rted Determines if this adapter supports Tunnel Directed Link Setup. Available only for API 21 or higher. Installationtime permissions countries. EMV 3-D Secure SDK
  • Device Information v2.1.0 Android-Specific Device Parameters / 39 Group or Identifier Bluetoot h Manager Element Description Comments Permissions Bluetooth Manager is used to conduct overall Bluetooth Management. Through Bluetooth Adapter, it facilitates in performing fundamental Bluetooth tasks, such as initiate device discovery, query a list of bonded (paired) devices, instantiate a BluetoothDevice using a known MAC address, and create a BluetoothServerSocke t to listen for connection requests from other devices, and start a scan for Bluetooth LE devices. This group of parameters requires following permission: android.permission. BLUETOOTH Installationtime permissions A039 Address Hardware address of the local Bluetooth adapter. Available only for API 18 or higher. Installationtime permissions A040 BondedDevic es Returns the set of BluetoothDevice ob jects that are bonded (paired) to the local adapter. Available only for API 18 or higher. Installationtime permissions A041 isEnabled Returns true if Bluetooth is currently enabled and ready for use. Installationtime permissions countries. EMV 3-D Secure SDK
  • Device Information v2.1.0 Android-Specific Device Parameters Group or Identifier Build Element Description Build is used to determine information about the current build, extracted from system properties. A042 BOARD Name of the underlying board, such as "goldfish". A043 BOOTLOADER System bootloader version number. A044 BRAND A045 DEVICE Consumer-visible brand with which the product/hardware will be associated, if any. Name of the industrial design. A046 DISPLAY Build ID string that is displayed to the user. A047 FINGERPRINT String that uniquely identifies this build. A048 A049 A050 HARDWARE Name of the hardware (from the kernel command line or /proc). ID Either a changelist number, or a label like "M4-rc20". MANUFACTURE Manufacturer of the R product/hardware. Comments / 39 Permissions No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. countries. EMV 3-D Secure SDK
  • Device Information v2.1.0 Android-Specific Device Parameters / 39 Group or Identifier Element A051 PRODUCT Description Name of the overall product. Comments Permissions No permissions required. A052 RADIO Radio firmware version number. No permissions required. A053 SERIAL Hardware serial number, if available. No permissions required. A054 SUPPORTED_3 2_BIT_ABIS Ordered list of 32bit ABIs supported by this device. The most preferred ABI is the first element in the list. Available only for API 21 or higher. No permissions required. A055 SUPPORTED_6 4_BIT_ABIS Ordered list of 64bit ABIs supported by this device. The most preferred ABI is the first element in the list Available only for API 21 or higher. No permissions required. A056 TAGS Comma-separated tags describing the build, such as "unsigned,debug". No permissions required. A057 TIME Build time. No permissions required. A058 TYPE Type of build, such as "user" or "eng". No permissions required. A059 USER No permissions required. countries. EMV 3-D Secure SDK
  • Device Information v2.1.0 Android-Specific Device Parameters Group or Identifier Build.VE RSION Element Description Indicates various version strings. A060 A061 A062 A063 A064 CODENAME The current development codename, or the string "REL" if this is a release build. INCREMENTAL The internal value used by the underlying source control to represent this build. PREVIEW_SDK The developer _INT preview revision of a prerelease SDK. SDK_INT The user-visible SDK version of the framework; its possible values are defined in Build.VERSION_CO DES. SECURITY_PA The user-visible TCH security patch level. Settings Secure Secure system settings, containing system preferences that applications can read but are not allowed to write. A065 ACCESSIBILI TY_DISPLAY_ INVERSION_E NABLED Specifies whether display color inversion is enabled. Comments / 39 Permissions No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. countries. EMV 3-D Secure SDK
  • Device Information v2.1.0 Android-Specific Device Parameters / 39 Group or Identifier A066 Element Description ACCESSIBILI Specifies whether TY_ENABLED accessibility is enabled. Comments Permissions No permissions required. A067 ACCESSIBILI TY_SPEAK_PA SSWOR9D Specifies whether to speak passwords while in accessibility mode. No permissions required. A068 ALLOWED_GEO LOCATION_OR IGINS Origins for which browsers should allow geolocation by default. The value is a space-separated list of origins. No permissions required. A069 ANDROID_ID 64-bit number (as a hex string) that is randomly generated when the end user first sets up the device. This number should remain constant for the lifetime of the end user's device. The value may change if a factory reset is performed on the device. No permissions required. A070 DATA_ROAMIN Determines whether G or not data roaming is enabled. Available only for API 17 or higher. No permissions required. A071 DEFAULT_INP Setting to record the UT_METHOD input method used by default. No permissions required. A072 DEVICE_PROV Determines whether ISIONED the device has been provisioned. Available only for API 17 or higher. No permissions required. countries. EMV 3-D Secure SDK
  • Device Information v2.1.0 Android-Specific Device Parameters / 39 Group or Identifier A073 Element Description ENABLED_ACC List of enabled ESSIBILITY_ accessibility SERVICES providers. Comments A074 ENABLED_INP List of input methods UT_METHODS that are currently enabled. A075 INPUT_METHO Setting to record the D_SELECTOR_ visibility of the input VISIBILITY method selector. A076 INSTALL_NON _MARKET_APP S Specifies whether applications can be installed for this user via the system's ACTION_IN STALL_PACKAGE mec hanism. A077 LOCATION_MO Degree of location DE access enabled by the end user. A078 SKIP_FIRST_ USE_HINTS If enabled, apps should try to skip any introductory hints on first launch. A079 SYS_PROP_SE TTING_VERSI ON Secure system settings, containing system preferences that applications can read but are not allowed to write. Available only for APIs below 24. A080 TTS_DEFAULT Default text-to-speech _PITCH engine pitch. A081 TTS_DEFAULT Default text-to-speech _RATE engine speech rate. Permissions No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. countries. EMV 3-D Secure SDK
  • Device Information v2.1.0 Android-Specific Device Parameters / 39 Group or Identifier A082 Element Description TTS_DEFAULT Default text-to-speech _SYNTH engine. Comments Permissions No permissions required. A083 TTS_ENABLED Space delimited list of _PLUGINS plugin packages that are enabled. No permissions required. Settings Global Global system settings, containing preferences that always apply identically to all defined users. No permissions required. A084 ADB_ENABLED Specifies whether ADB is enabled. Available only for API 17 or higher. No permissions required. A085 AIRPLANE_MO DE_RADIOS Comma-separated list of radios that need to be disabled when airplane mode is on. Available only for API 17 or higher. No permissions required. A086 ALWAYS_FINI SH_ACTIVITI ES If 1, the activity manager will aggressively finish activities and processes as soon as they are no longer needed. Available only for API 17 or higher. No permissions required. A087 ANIMATOR_DU Scaling factor for RATION_SCAL animator-based E animations. Available only for API 17 or higher. No permissions required. A088 AUTO_TIME Value to specify whether the user prefers the date, time and time zone to be automatically fetched from the network (NITZ). Available only for API 17 or higher. No permissions required. countries. EMV 3-D Secure SDK
  • Device Information v2.1.0 Android-Specific Device Parameters / 39 Group or Identifier A089 Element Description AUTO_TIME_Z ONE Value to specify whether the user prefers the time zone to be automatically fetched from the network (NITZ). Comments Available only for API 17 or higher. Permissions No permissions required. A090 DEVELOPMENT _SETTINGS_E NABLED Determines whether the end user has enabled development settings. Available only for API 17 or5 higher. No permissions required. A091 HTTP_PROXY Host name and port for global http proxy. Available only for API 17 or higher. No permissions required. A092 NETWORK_PRE User preference for FERENCE which networks should be used. Available only for API 17 or higher. No permissions required. A093 STAY_ON_WHI LE_PLUGGED_ IN Determines whether the device must remain switched on while it is plugged in. Available only for API 17 or higher. No permissions required. A094 TRANSITION_ Scaling factor for ANIMATION_S activity transition CALE animations. Available only for API 17 or higher. No permissions required. A095 USB_MASS_ST Indicates whether ORAGE_ENABL USB mass storage is ED enabled. Available only for API 17 or higher. No permissions required. A096 USE_GOOGLE_ MAIL If this setting is set (to anything), then all references to Gmail on the device must change to Google Mail. Available only for API 17 or higher. No permissions required. countries. EMV 3-D Secure SDK
  • Device Information v2.1.0 Android-Specific Device Parameters / 39 Group or Identifier A097 Element Description Comments WAIT_FOR_DE BUGGER If 1, when launching DEBUG_APP it will wait for the debugger before starting user code. Available only for API 17 or higher. Permissions No permissions required. A098 WIFI_NETWOR KS_AVAILABL E_NOTIFICAT ION_ON Determines whether the end user should be notified of open networks. Available only for API 17 or higher. No permissions required. Settings System System settings, containing miscellaneous system preferences. No permissions required. A099 ACCELEROMET ER_ROTATION Control whether the accelerometer will be used to change screen orientation. No permissions required. A100 BLUETOOTH_D ISCOVERABIL ITY Determines whether remote devices may discover and/or connect to this device. No permissions required. A101 BLUETOOTH_D Bluetooth ISCOVERABIL discoverability ITY_TIMEOUT timeout. No permissions required. A102 DATE_FORMAT Date format string mm/dd/yyyy dd/mm/yyyy yyyy/mm/dd. No permissions required. A103 DTMF_TONE_T YPE_WHEN_DI ALING CDMA only settings + DTMF tone type played by the dialer when dialing No permissions required. countries. EMV 3-D Secure SDK
  • Device Information v2.1.0 Android-Specific Device Parameters Group or Identifier A104 Element Description DTMF_TONE_W HEN_DIALING Whether the audible DTMF tones are played by the dialer when dialing. A105 END_BUTTON_ BEHAVIOR The behavior when the user presses the end call button if they're not on a call. A106 FONT_SCALE Scaling factor for fonts, float. A107 A108 A109 A110 A111 A112 A113 HAPTIC_FEED Whether the haptic BACK_ENABLE feedback (long D presses) is enabled. MODE_RINGER _STREAMS_AF FECTED Determines which streams are affected by ringer mode changes. NOTIFICATIO N_SOUND Persistent store for the system-wide default notification sound. MUTE_STREAM Determines which S_AFFECTED streams are affected by mute. RINGTONE Persistent store for the system-wide default ringtone URI. SCREEN_BRIG The screen backlight HTNESS brightness between 0 and 255. SCREEN_BRIG Control whether to HTNESS_MODE enable automatic brightness mode. Comments / 39 Permissions No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. countries. EMV 3-D Secure SDK
  • Device Information v2.1.0 Android-Specific Device Parameters Group or Identifier A114 Element Description SCREEN_OFF_ TIMEOUT The amount of time in milliseconds before the device goes to sleep or begins to dream after a period of inactivity. This value is also known as the user activity timeout period since the screen isn't necessarily turned off when it expires. A115 SOUND_EFFEC Whether sounds TS_ENABLED effects (key clicks, lid open) are enabled. A116 TEXT_AUTO_C Setting to enable Auto APS Caps in text editors. A117 A118 A119 A120 A121 TEXT_AUTO_P Setting to enable Auto UNCTUATE Punctuate in text editors TEXT_AUTO_R Setting to enable Auto EPLACE Replace (AutoText) in text editors. TEXT_SHOW_P Setting to showing ASSWORD password characters in text editors. TIME_12_24 Display time in the 12hour format or the 24hour format. USER_ROTATI Default screen ON rotation when no other policy applies. Comments / 39 Permissions No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. countries. EMV 3-D Secure SDK
  • Device Information v2.1.0 Android-Specific Device Parameters Group or Identifier Element A122 VIBRATE_ON Description Whether vibrate is on for different events. A123 VIBRATE_WHE N_RINGING Whether the phone vibrates when it is ringing during an incoming call. Package Manager Package Manager is used to retrieve various kinds of information related to the application packages that are currently installed on the device. A124 isSafeMode Returns whether the device has been booted into safe mode. A125 getInstalle dApplicatio ns Returns a list of application packages that are installed on the device. A126 getInstalle rPackageNam e Retrieves the package name of the application that installed a package. This identifies which market the package came from. Comments / 39 Permissions No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. countries. EMV 3-D Secure SDK
  • Device Information v2.1.0 Android-Specific Device Parameters Group or Identifier A127 Element Description getSystemAv ailableFeat ures Retrieves a list of features that are available on the device. The 3DS SDK shall share only the length of this list and not the full list itself. A128 getSystemSh aredLibrary Names Retrieves a list of shared libraries that are available on the device. The 3DS SDK shall share only the length of this list and not the full list itself. Environm ent Environment provides access to environment variables. A129 getExternal StorageStat e Returns the current state of the primary shared/external storage media. Locale Represents a specific geographical, political, or cultural region. A130 getAvailabl Returns the system's eLocales installed locales. The 3DS SDK shall share only the length of this list and not the full list itself. Comments / 39 Permissions No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. countries. EMV 3-D Secure SDK
  • Device Information v2.1.0 iOS-Specific Device Parameters Group or Identifier DisplayM etrics Element A131 density Description DisplayMetrics describes general information about a display, such as its size, density, and font scaling. The logical density of the display. A132 A133 A134 A135 StatFs A136 densityDpi The screen density expressed as dotsper-inch. scaledDensi A scaling factor for ty fonts displayed on the display. xdpi The exact physical pixels per inch of the screen in the X dimension. ydpi The exact physical pixels per inch of the screen in the Y dimension. StatFs retrieves overall information about the space on a filesystem. getTotalByt The total number of es bytes supported by the filesystem. Comments / 39 Permissions No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. No permissions required. 2.6 iOS-Specific Device Parameters Table 2.4 provides information about the device parameters that shall be collected by the 3DS SDK from the iOS mobile platform for risk analysis by the ACS. countries. EMV 3-D Secure SDK
  • Device Information v2.1.0 iOS-Specific Device Parameters / 39 In this table, the Group or Identifier column contains the name of the parameter group or parameter identifier. Note: The 3DS SDK does not require any permissions to collect these parameters. Note: Each parameter listed in this table shall be collected by the 3DS SDK unless the parameter cannot be collected for any of the reasons stated in Table 2.6. Group or Identifier UIDevice I001 I002 UIFont I003 I004 I005 I006 I007 I008 I009 Table 2.4: iOS-Specific Device Parameters Attribute Description Identifier For Vendor UserInterfaceIdiom familyNames fontNamesForFamilyName systemFont labelFontSize buttonFontSize smallSystemFontSize systemFontSize UIDevice provides a singleton instance representing the current device. Alphanumeric string that uniquely identifies a device to the app’s vendor. Style of interface to use on the current device. UIFont provides the interface for getting and setting font information. Returns an array of font family names available on the system. Returns an array of font names available in a particular font family using the system font family. System font Returns the standard font size used for labels. Returns the standard font size used for buttons. Returns the size of the standard small system font. Returns the size of the standard system font. countries. EMV 3-D Secure SDK
  • Device Information v2.1.0 Windows 10 Mobile-Specific Device Parameters / 39 Group or Identifier NSLocale I010 I011 I012 NSTimeZone I013 Attribute Description NSLocale encapsulates all of the conventions about language and culture for a particular locale. systemLocale Returns the ID of the generic locale that contains fixed "backstop" settings that provide values for otherwise undefined keys. availableLocaleIdentifie Returns an array of NSString objects, rs each of which identifies a locale available on the system. preferredLanguages Returns the user's language preference order as an array of strings. NSTimeZone defines the behavior of time zone objects. defaultTimeZone Returns the default time zone for the current application.

2.7 Windows 10 Mobile-Specific Device Parameters Table 2.5 provides information about the device parameters that shall be collected by the 3DS SDK from the Windows 10 Mobile mobile platform for risk analysis by the ACS. In this table, the Group or Identifier column contains the name of the parameter group or parameter identifier. Note: The 3DS SDK does not require any permissions to collect these parameters. Note: Each parameter listed in this table shall be collected by the 3DS SDK unless the parameter cannot be collected for any of the reasons stated in Table 2.6.

countries. EMV 3-D Secure SDK

  • Device Information v2.1.0 Windows 10 Mobile-Specific Device Parameters / 39 Table 2.5: Windows 10 Mobile-Specific Device Parameters Group or Identifier Globalizati on Preferences Attribute Description GlobalizationPreferences is used to obtain the user’s globalization preferences. W001 W002 W003 W004 W005 W006 External Storage Device Calendars Gets the set of calendars that are preferred by the user, in the order of preference. Clocks Gets the set of clocks that are preferred by the user, in the order of preference. Currencies Gets the set of currencies that are preferred by the user, in the order of preference. HomeGeographicRegion Gets the user's home geographic region. Languages Gets the set of languages preferred by the user, in the order of preference. WeekStartsOn Gets the day of the week that is considered to be the first day of the week. W007 ExternalStorageID AnalyticsIn fo W008 DeviceForm EasClientDe viceInforma tion W009 Id Gets the ID value that uniquely identifies the SD card. AnalyticsInfo provides information about the device for profiling purposes. Gets the device form. EasClientDeviceInformation provides apps the ability to retrieve device information from the local device. Returns the identifier of the local device. countries. EMV 3-D Secure SDK
  • Device Information v2.1.0 Windows 10 Mobile-Specific Device Parameters / 39 Group or Identifier W010 Attribute Description SystemFirmwareVersio Returns the system firmware version of the n local device. W011 SystemHardwareVersio Returns the system hardware version of the n local device. W012 SystemManufacturer Returns the system manufacturer of the local device. W013 SystemProductName Returns the system product name of the local device. W014 SystemSku Returns the system SKU of the local device. DisplayInfo rmation DisplayInformation monitors and controls physical display information. W015 AutoRotationPreferen Gets and sets the preferred orientation of the ces app. W016 CurrentOrientation Gets the current orientation of a rectangular monitor. W017 LogicalDpi Gets the pixels per logical inch of the current environment. W018 NativeOrientation Gets the native orientation of the display monitor, which is typically the orientation where the buttons on the device match the orientation of the monitor. W019 RawDpiX Gets the raw dots per inch (DPI) along the Xaxis of the display monitor. W020 RawDpiY Gets the raw dots per inch (DPI) along the Yaxis of the display monitor. W021 RawPixelsPerViewPixe Gets a value representing the number of raw l (physical) pixels for each view (layout) pixel. W022 ResolutionScale Gets the scale factor of the immersive environment. countries. EMV 3-D Secure SDK
  • Device Information v2.1.0 Reasons for Device Parameters Unavailability / 39 Group or Identifier W023 Attribute StereoEnabled Network Information W024 GetNetworkNames HostInforma tion W025 PublisherHostId Description Gets a value that indicates whether the device supports stereoscopic 3D. Network Information provides access to network connection information for the local machine. Retrieves names associated with the network with which the connection is currently established. HostInformation provides access to a string that uniquely identifies a device per publisher. A string that uniquely identifies a device. This string is unique per device and per publisher, which means that no two publishers will receive the same value for the same device.

2.8 Reasons for Device Parameters Unavailability Table 2.6 provides a list of reason codes and descriptions to address the unavailability of a device parameter. In case a 3DS SDK is unable to collect a particular device parameter, then the reason for the same shall be sent in the device parameters JSON with the key as "DPNA", as shown in the sample provided in Table 2.7. Table 2.6: Device Parameter Unavailability Reasons Reason Code RE01 Description Market or regional restriction on the parameter. RE02 Platform version does not support the parameter or the parameter has been deprecated. RE03 Parameter collection not possible without prompting the user for permission.

countries. EMV 3-D Secure SDK - Device Information v2.1.0 Device Information JSON Data

/ 39 2.9 Device Information JSON Data Table 2.7 provides a sample device parameters JSON. As shown in the sample JSON, the following keys are used in conjunction with the keys for the device identification parameters:

  • DV: Data Version
  • DD: Device Data
  • DPNA: Device Parameter Not Available
  • SW: Security Warning. For information about Security Warning, refer to the EMV 3-D Secure SDK Specification. Table 2.7: Device Parameters JSON Structure Platform Android Device Information {"DV":"1.0","DD":{"C001":"Android","C002":"HTC One_M8","C004":"5.0.},"DPNA":{"C010":"RE01","C011":"RE 03"},"SW":["SW01","SW04"]} iOS {"DV":"1.0","DD":{"C001":"iOS","C002":"iPhone 5c","C003":" iPhone OS ","C004":"9.}," DPNA":{"C010":"RE01","C011":"RE03"},"SW":["SW0 1","SW04"]} Windows 10 Mobile {"DV":"1.0","DD":{"C001":"Windows","C002":"NOK IA RM984_1006","C003":"WindowPhone","C004":"10.0.10 586.},"DPNA":{"C010":"RE02","C011":"RE0 3"},"SW":["SW01","SW04"]} countries. EMV 3-D Secure SDK - Device Information v2.1.0 Device Information JSON Data / 39 *** END OF DOCUMENT *** countries.