You can use the LexisNexis connector to:

  • Get fraud and risk assessments from the LexisNexis Instant Verify International (IVI) service, which uses digital identity intelligence, behavioral analytics, machine learning, external data sources, and case management to continually improve decisions
  • Get risk assessments from ThreatMetrix
  • Get insights into identity data associated with phone numbers and email addresses
  • Authenticate users with OTPs
  • Verify identity documentation with TrueID

Setup

Resources

For information and setup help, see the following:

Requirements

To use the connector, you'll need:

  • A LexisNexis account
  • Credentials and access details for the LexisNexis services that you want to use

Configuring the LexisNexis connector

Add the connector in DaVinci as shown in Adding a connector, then configure it as follows.

Connector configuration

General
API URL

The API URL to target for the Phone Finder, ID Verification, and ThreatMetrix services. For a custom value, select Use Custom API URL and enter a value in the Custom API URL field.

Custom API URL
The base URL for the Phone Finder, ID Verification, and ThreatMetrix services, such as https://lexisnexis.mydomain.com.
Organization ID
The organization ID provided to you by LexisNexis.
API Key
The API key provided to you by LexisNexis.
Javascript CDN URL
The URL for the ThreatMetrix device profiling script. The default value is https://h.online-metrix.net/fp/tags.js.
Authentication Project
Note:

These settings are needed for the Instant Verify International (IVI) capability.

API Base URL
The base URL for the Authentication Project service. The default value is https://h-api.online-metrix.net/authentication/v1/.
Important:

Include / at the end.

Organization ID
The LexisNexis organization ID provided to you by LexisNexis.
API Key
Your LexisNexis API key provided to you by LexisNexis.
OTP, KBA, and TrueID
API Base URL
The base URL for the OTPs, Knowledge Based Authentication (KBA), and TrueID services. The default value is https://h-api-us.online-metrix.net.
Account ID
The LexisNexis account ID provided to you by LexisNexis for OTPs, KBA, or TrueID.
Username
The username provided to you by LexisNexis for OTPs, KBA, or TrueID.
Password
The password provided to you by LexisNexis for OTPs, KBA, or TrueID.
TrueID
Username
The username provided to you by LexisNexis for TrueID.
Password
The password provided to you by LexisNexis for TrueID.
ACAS Endpoint
The Assured Compliance Assessment Solution (ACAS) endpoint provided to you by LexisNexis.
Acuant JavaScript Web SDK Script Source

Select a version of the SDK files hosted by Ping Identity, or select Use External Acuant Script URLs and provide the locations for your own externally-hosted files in the External Acuant Script URL fields that appear.

For more information, see Acuant JavaScript Web SDK on GitHub.

Emailage
API Base URL
The base URL for Emailage service. The default value is https://api.emailage.com.
Client ID
The client ID provided to you by LexisNexis for Emailage.
Client Secret
The client secret provided to you by LexisNexis for Emailage.

Using the connector in a flow

Verify identity documents with TrueID

The connector allows you to prompt users to submit their driver license or passport along with selfie photos. TrueID verifies the documents and provides a result. This process is meant to be triggered on a device that has access to a camera.

To use the TrueID: Verify Document capability in a flow, first configure the TrueID in the connector configuration. This allows you to select the source of the SDK files that the connector uses to present the document verification interface.

  1. In your connector configuration, on the TrueID tab, configure your access details and select the Acuant JavaScript Web SDK Source for the connector to use for the document verification process.
  2. In your flow, add the LexisNexis connector with the TrueID: Verify Document capability.
  3. Populate the capability properties according to the help text.
  4. (Optional) Customize the user interfaces:
    1. On the Custom Screens tab, in the Welcome page section, customize the welcome page.

      Note:

      The connector uses the pre-filled contents of the Script field to load the Web SDK files. DonIf you need to add your own scripts, don't modify this existing functionality.

      The welcome page
      A screen capture of the user's view of the first HTML template, which welcomes the user.
    2. In the Photo prompt page section, customize the photo prompt page.

      The photo prompt page
      A screen capture of the user's view of the first HTML template, which prompts the users to submit three photos.

Verifying user information with IVI

A screen capture of the entire IVI flow.

This flow uses Instant Verify International (IVI) to check personal identity information against the national databases, electoral rolls, property records, utility data, and marketing sources of 30 countries and regions. The flow branches based on whether IVI returns a pass or fail response and also returns other information about the person.

  1. Download the LexisNexis - Instant Verify International flow template. For help, see Using DaVinci flow templates.
  2. (Optional) Customize the sign on form:
    A screen capture that shows the test information entered in the Verification Form.
    1. Select the Verification Form node.
    2. (Optional) Customize the Title field.
    3. (Optional) Customize the Next Button Text field.
    4. Click Apply.
  3. Customize the Instant Verify International settings:
    1. Select the Instant Verify International node.
    2. In the Policy field, enter the name of the LexisNexis policy you want to use, such as default.
      Tip:

      To see your policies, sign on to the LexisNexis portal, go to Policies. Copy the Policy Name.

    3. In the Service Type list, select your service type. For help, speak to a LexisNexis representative.
    4. For each of the remaining user attributes, populate the field with a variable by clicking {} and selecting a variable from your flow, or enter a static value, or leave the attribute blank.
    5. Click Apply.
  4. Test your flow:
    1. Click Save, Deploy, then Run.
    2. Complete the Verification Form.
    3. Click Check my information.
    4. On the Your results page, see the resulting transaction status.

Getting a ThreatMetrix risk assessment


A screen capture that shows the complete flow.

This flow uses the connector to generate a device profile and send it to ThreatMetrix, then uses the resulting session ID to get a risk assessment. The flow branches based on the review status provided in the risk assessment.

  1. Download the LexisNexis - ThreatMetrix risk assessment flow template. For help, see Using DaVinci flow templates.
  2. (Optional) Customize the device profiling message:
    1. Select the ThreatMetrix: Send Device Profile node.
    2. In the Initialization Loading Text field, customize the text that appears below the spinner animation during device profiling.
    3. Click Apply.
  3. Customize the risk assessment settings:
    1. Select the ThreatMetrix: Get Risk Assessment node.
    2. (Optional) In the Service Type list, select the service type associated with your API key.
    3. In the Event Type list, select the event type that best describes the function of your flow.
    4. (Optional) Map any of the additional attribute fields by clicking {} and selecting a variable from your flow or by entering a static value. DaVinci sends these attributes sent to ThreatMetrix for use in the risk assessment.
    5. Click Apply.
  4. Test the flow.
    1. Click Save, Deploy, then Run.
    2. See which review status message you receive.
    3. Test different review statuses by modifying your ThreatMetrix policies. See the ThreatMetrix documentation for help.

Capabilities

ThreatMetrix: Send Device Profile

Run the device profiling script, submit the profile, and get a session ID.

Details
Details
Properties
Initialization Loading text textField
Input Schema
default object
javascriptCdnUrl string required
orgId string required
Output Schema
output object
sessionId string
ThreatMetrix: Get Profiling URL

Get a unique URL and session ID to use for device profiling in a custom page.

Details
Details
Input Schema
default object
javascriptCdnUrl string required
orgId string required
Output Schema
output object
cdnUrl string
sessionId string
Instant Verify International

Use LexisNexis DDP for multi-faceted fraud and risk assessment.

Details
Details
Properties
Policy textField required

The name of your policy in the Dynamic Decision Platform (DDP).

Service Type dropDown

Restricts which output fields are returned based on the level of access that a customer has. The service type is linked to your API key.

  • Basic
  • Session Policy
  • Device
  • DID
  • IP
  • Session
  • All (Default)
  • 3ds
First Name textField

The primary account holder's first name.

Middle Name textField

The primary account holder's middle name

Last Name textField

The primary account holder's last name

Street Address 1 textField

The primary account holder's street address 1

Street Address 2 textField

The primary account holder's street address 2

City textField

The primary account holder's city

State textField

The primary account holder's State

ZIP textField

The primary account holder's ZIP

Country textField

The primary account holder's country, in ISO 3166-1 alpha-2 format, such as "US".

Account Email textField

The primary account holder's email address.

Telephone Number textField

The primary account holder's telephone number. Can contain the following characters: 0-9 , . ; { } ( and ). All braces must be in pairs. White space is removed automatically.

Account Work Phone textField

The primary account holder's work telephone number. This field is not an entity.

Date of Birth textField

The primary account holder's date of birth, formatted as YYYYMMDD.

Gender textField

The primary account holder's gender.

National ID Number textField
National ID Type dropDown

The Type of National Id that will be used for verification.

  • US_SSN
  • US_SSN_HASH
  • US_SSN4
  • US_SSN_FIRST5
  • BR_CPF
  • MX_CURP
  • CO_CEDULA
Driver License Number textField

The primary account holder's driver license number.

Driver License Issuer textField

Primary account driver license issuer

Routing Address textField

The primary account holder's routing address.

Routing Standard textField

The primary account holder's routing standard.

Account Number textField

The primary account holder's account number.

Passport Number textField

The primary account holder's passport number.

Passport machine Readable Line 1 textField

The primary account holder's passport information in machine-readable format, line 1.

Passport machine Readable Line 2 textField

The primary account holder's passport information in machine-readable format, line 2.

Passport Expiration Date textField

The primary account holder's passport expiration date, formatted as YYYY-MM-DD.

Passport Country textField

The primary account holder's passport country, in ISO 3166-1 alpha-2 format, such as “US”.

Transaction ID textField

The identifier used by the merchant to identify the transaction, such as a purchase order number.

Credit Card Number textField

The credit card number used in the transaction.

Online TLD textField

The description of the online TLD handle source. Used to prevent collisions between different online TLD handles. For help determining the correct online TLD for the ID you wish to send with your query, speak to a LexisNexis representative. This field is required if the Online TLD Handle field is populated.

Online TLD Handle textField

A unique third-party identifier, such as a LexID or a DUNS Number. Used for rule creation and investigation. This field is required if the Online TLD field is populated.

Line of Business textField

The line of business specified by the customer.

Application Name textField

The name of the application sending the event.

Shipping Account Holder's Street Address 1 textField

The shipping account holder's street address, line 1.

Shipping Account Holder's Street Address 2 textField

The shipping account holder's street address, line 2.

Shipping Account Holder's City textField

The shipping account holder's city.

Shipping Account Holder's State textField

The shipping account holder's state.

Shipping Account Holder's ZIP or Postal Code textField

The shipping account holder's ZIP or postal code.

Shipping Account Holder’s Country textField

The shipping account holder's country, in ISO 3166-1 alpha-2 format, such as “US”.

Routing Number textField

The routing number for the account. When using this attribute in a Condition/Expression Condition rule or Expression variable, the value will be treated as a string if quotes are used to enclose it and as a number if no quotes are used.

Transaction Amount textField

The numeric currency amount. If a decimal is used, exactly two digits must follow it.

Transaction Currency textField

The currency used for the transaction, formatted in ISO 4217 currency code, such as “USD”. This field is required when Transaction Amount is populated.

Account Login textField

A unique identifier for the customer, such as a username or account ID. Used to check whether the customer is on a watch list.

Password textField

The password associated with the Account Login. This is hashed and sent to LexisNexis. Used to check whether the customer is on a watch list.

Social Security Number textField

The customer's social security number.

Account Number (Hash) textField

The customer's account number. This is hashed and sent to LexisNexis.

Driver License Number (Hash) textField

The customer's driver license number. This is hashed and sent to LexisNexis.

IP Address textField

The customer's IP address as detected by a web server. This must be a valid external address.

Page FingerPrint textField

The page fingerprint. This is hashed and sent to LexisNexis.

Device ID textField

The ExactID persistent global identifier, which relies on a variety of persistent markers (browser cookies, Adobe Flash cookies, HTML 5 local storage) to allow ThreatMetrix to 100% accurately identify a device.

Fuzzy Device ID textField

The SmartID device identifier, which is cookieless, and is based exclusively on device attributes to improve detection of returning visitors, especially those trying to elude identification, and reduces false positives.

HTTP Referer Domain textField

For TD Cloud, the domain of the HTTP referrer detected during profiling. For TD Mobile, this field can be optionally populated by the ‘Custom URL’ option in the TrustDefender Mobile Library. This relates to the Profiled Domain property below but only includes the domain portion of the passed URL as opposed to the whole URL which is present in the Profiled Domain property. This is passed to the library by the customer’s native application. Described in more detail in the TMX Knowledgebase, Article ID 378.

Profiled Domain textField

For TD Cloud, the URL (i.e. domain + path + querystring) of the referring page. For TD Mobile, the same as the HTTP Referer Domain property.

Input Schema
default object
apiUrl string required
apiKey string required
orgId string required
policy string required
service_type string required
account_first_name string
account_middle_name string
account_last_name string
account_address_street1 string
account_address_street2 string
account_address_city string
account_address_state string
account_address_zip string
account_address_country string
account_email string
account_telephone string
account_work_phone string
account_date_of_birth string
account_gender string
national_id_number string
national_id_type string
account_drivers_license_number string
account_drivers_license_issuer string
account_routing_address string
account_routing_standard string
account_number string
account_passport_number string
account_passport_machine_readable_line1 string
account_passport_machine_readable_line2 string
account_passport_expiration_date string
account_passport_country string
transaction_id string
cc_number_hash string
online_tld string
online_tld_handle string
line_of_business string
application_name string
shipping_account_address_street1 string
shipping_account_address_street2 string
shipping_account_address_city string
shipping_account_address_state string
shipping_account_address_zip string
shipping_account_address_country string
ach_routing_number string
transaction_amount number
transaction_currency string
account_login string
password_hash string
ssn_hash string
ach_account_hash string
drivers_licence_number_hash string
input_ip_address string
page_fingerprint string
device_id string
fuzzy_device_id string
http_referer_domain string
profiled_domain string
Output Schema
output object
rawResponse object
properties object
account_address_city string
account_address_state string
account_address_street1 string
account_address_zip string
account_date_of_birth string
account_first_name string
account_last_name string
account_telephone string
account_telephone_is_possible string
account_telephone_is_valid string
account_telephone_type string
api_call_datetime string
api_type string
api_version string
champion_request_duration string
custom_count_10 string
custom_count_12 string
custom_count_15 string
custom_count_8 string
custom_count_9 string
custom_output_11 array
items array
type string
custom_output_12 array
items array
type string
custom_output_13 array
items array
type string
custom_output_14 array
items array
type string
custom_output_15 array
items array
type string
custom_output_16 array
items array
type string
custom_output_7 array
items array
type string
custom_output_9 array
items array
type string
event_datetime string
event_type string
integration_hub_results object
properties object
3c8qvza7:DIIG Identity Verification object
properties object
Execute DIIG object
properties object
rule_id string
tps_datetime string
tps_duration string
tps_result string
tps_type string
tps_vendor string
tps_vendor_raw_response string
tps_was_timeout string
national_id_number string
national_id_type string
org_id string
policy string
policy_details_api object
properties object
policy_detail_api array
items array
type object
properties {"type":"string"}
policy_engine_version string
policy_score string
reason_code array
items array
type string
request_id string
request_result string
review_status string
risk_rating string
service_type string
tps_was_timeout string
transactionStatus string
ThreatMetrix: Get Risk Assessment

Get a risk assessment from ThreatMetrix using a session ID and optional attributes.

Details
Details
Properties
Service Type dropDown

Restricts which output fields are returned based on the level of access that a customer has. The service type is linked to your API key.

  • Basic
  • Session Policy
  • Device
  • DID
  • IP
  • Session
  • All (Default)
  • 3ds
Event Type dropDown

NOTE: If event_type is passed to attribute query, it WILL increment velocity counters etc just like a session query. if there is no event_type on attribute query, it will run but not increment velocity etc counters.

  • Login
  • Payment
  • Account Creation (Default)
  • Transfer
  • Transaction Other
  • Auction Bid
  • Details Change
  • Add Listing
  • Account Balance
  • Transaction History
  • Digital Download
  • Digital Stream
Session ID textField

LexisNexis Session ID.

First Name textField

The primary account holder's first name.

Middle Name textField

The primary account holder's middle name

Last Name textField

The primary account holder's last name

Street Address 1 textField

The primary account holder's street address 1

Street Address 2 textField

The primary account holder's street address 2

City textField

The primary account holder's city

State textField

The primary account holder's State

ZIP textField

The primary account holder's ZIP

Country textField

The primary account holder's country, in ISO 3166-1 alpha-2 format, such as "US".

Account Email textField

The primary account holder's email address.

Telephone Number textField

The primary account holder's telephone number. Can contain the following characters: 0-9 , . ; { } ( and ). All braces must be in pairs. White space is removed automatically.

Account Work Phone textField

The primary account holder's work telephone number. This field is not an entity.

Date of Birth textField

The primary account holder's date of birth, formatted as YYYYMMDD.

Gender textField

The primary account holder's gender.

National ID Number textField

The primary account holder's national ID number. Used for identity verification.

National ID Type dropDown

The primary account holder's national ID type. Used for identity verification.

  • US SSN
  • US SSN HASH
  • US SSN4
  • US SSN FIRST5
  • BR CPF
  • MX CURP
  • CO CEDULA
Driver License Number textField

The primary account holder's driver license number.

Driver License Issuer textField

Primary account driver license issuer

Routing Address textField

The primary account holder's routing address.

Routing Standard textField

The primary account holder's routing standard.

Account Number textField

The primary account holder's account number.

Passport Number textField

The primary account holder's passport number.

Passport machine Readable Line 1 textField

The primary account holder's passport information in machine-readable format, line 1.

Passport machine Readable Line 2 textField

The primary account holder's passport information in machine-readable format, line 2.

Passport Expiration Date textField

The primary account holder's passport expiration date, formatted as YYYY-MM-DD.

Passport Country textField

The primary account holder's passport country, in ISO 3166-1 alpha-2 format, such as “US”.

Transaction ID textField

The identifier used by the merchant to identify the transaction, such as a purchase order number.

Credit Card Number textField

The credit card number used in the transaction.

Online TLD textField

The description of the online TLD handle source. Used to prevent collisions between different online TLD handles. For help determining the correct online TLD for the ID you wish to send with your query, speak to a LexisNexis representative. This field is required if the Online TLD Handle field is populated.

Online TLD Handle textField

A unique third-party identifier, such as a LexID or a DUNS Number. Used for rule creation and investigation. This field is required if the Online TLD field is populated.

Line of Business textField

The line of business specified by the customer.

Application Name textField

The name of the application sending the event.

Shipping Account Holder's Street Address 1 textField

The shipping account holder's street address, line 1.

Shipping Account Holder's Street Address 2 textField

The shipping account holder's street address, line 2.

Shipping Account Holder's City textField

The shipping account holder's city.

Shipping Account Holder's State textField

The shipping account holder's state.

Shipping Account Holder's ZIP or Postal Code textField

The shipping account holder's ZIP or postal code.

Shipping Account Holder’s Country textField

The shipping account holder's country, in ISO 3166-1 alpha-2 format, such as “US”.

Routing Number textField

The routing number for the account. When using this attribute in a Condition/Expression Condition rule or Expression variable, the value will be treated as a string if quotes are used to enclose it and as a number if no quotes are used.

Transaction Amount textField

The numeric currency amount. If a decimal is used, exactly two digits must follow it.

Transaction Currency textField

The currency used for the transaction, formatted in ISO 4217 currency code, such as “USD”. This field is required when Transaction Amount is populated.

Account Login textField

A unique identifier for the customer, such as a username or account ID. Used to check whether the customer is on a watch list.

Password textField

The password associated with the Account Login. This is hashed and sent to LexisNexis. Used to check whether the customer is on a watch list.

Social Security Number textField

The customer's social security number.

Account Number (Hash) textField

The customer's account number. This is hashed and sent to LexisNexis.

Driver License Number (Hash) textField

The customer's driver license number. This is hashed and sent to LexisNexis.

IP Address textField

The customer's IP address as detected by a web server. This must be a valid external address.

Page FingerPrint textField

The page fingerprint. This is hashed and sent to LexisNexis.

Device ID textField

The ExactID persistent global identifier, which relies on a variety of persistent markers (browser cookies, Adobe Flash cookies, HTML 5 local storage) to allow ThreatMetrix to 100% accurately identify a device.

Fuzzy Device ID textField

The SmartID device identifier, which is cookieless, and is based exclusively on device attributes to improve detection of returning visitors, especially those trying to elude identification, and reduces false positives.

HTTP Referer Domain textField

For TD Cloud, the domain of the HTTP referrer detected during profiling. For TD Mobile, this field can be optionally populated by the ‘Custom URL’ option in the TrustDefender Mobile Library. This relates to the Profiled Domain property below but only includes the domain portion of the passed URL as opposed to the whole URL which is present in the Profiled Domain property. This is passed to the library by the customer’s native application. Described in more detail in the TMX Knowledgebase, Article ID 378.

Profiled Domain textField

For TD Cloud, the URL (i.e. domain + path + querystring) of the referring page. For TD Mobile, the same as the HTTP Referer Domain property.

Input Schema
default object
apiUrl string required
apiKey string required
orgId string required
service_type string required
account_first_name string
account_middle_name string
account_last_name string
account_address_street1 string
account_address_street2 string
account_address_city string
account_address_state string
account_address_zip string
account_address_country string
account_email string
account_telephone string
account_work_phone string
account_date_of_birth string
account_gender string
account_national_id_number string
account_national_id_type string
account_drivers_license_number string
account_drivers_license_issuer string
account_routing_address string
account_routing_standard string
account_number string
account_passport_number string
account_passport_machine_readable_line1 string
account_passport_machine_readable_line2 string
account_passport_expiration_date string
account_passport_country string
event_type string
transaction_id string
cc_number_hash string
online_tld string
online_tld_handle string
line_of_business string
application_name string
shipping_account_address_street1 string
shipping_account_address_street2 string
shipping_account_address_city string
shipping_account_address_state string
shipping_account_address_zip string
shipping_account_address_country string
ach_routing_number string
transaction_amount number
transaction_currency string
sessionId string
account_login string
password_hash string
ssn_hash string
ach_account_hash string
drivers_licence_number_hash string
input_ip_address string
page_fingerprint string
device_id string
fuzzy_device_id string
http_referer_domain string
profiled_domain string
Output Schema
output object
rawResponse object
properties object
account_address_city string
account_address_state string
account_address_street1 string
account_address_zip string
account_date_of_birth string
account_first_name string
account_last_name string
account_telephone string
account_telephone_is_possible string
account_telephone_is_valid string
account_telephone_type string
api_call_datetime string
api_type string
api_version string
champion_request_duration string
custom_count_15 string
event_datetime string
event_type string
national_id_number string
national_id_type string
org_id string
policy string
policy_details_api object
properties object
policy_detail_api array
items array
type object
properties {"type":"string"}
policy_engine_version string
policy_score string
reason_code array
items array
type string
request_id string
request_result string
review_status string
risk_rating string
service_type string
Phone Finder

Search by phone number or identity to get ranked results with data insights like phone type, status, CallerID, and portability.

Details
Details
Properties
Service Type dropDown

Restricts which output fields are returned based on the level of access that a customer has. The service type is linked to your API key.

  • Basic
  • Session Policy
  • Device
  • DID
  • IP
  • Session
  • All (Default)
  • 3ds
Telephone Number textField

The primary account holder's telephone number. Can contain the following characters: 0-9 , . ; { } ( and ). All braces must be in pairs. White space is removed automatically.

First Name textField

The primary account holder's first name.

Middle Name textField

The primary account holder's middle name

Last Name textField

The primary account holder's last name

Street Address 1 textField

The primary account holder's street address 1

Street Address 2 textField

The primary account holder's street address 2

City textField

The primary account holder's city

State textField

The primary account holder's State

ZIP textField

The primary account holder's ZIP

Country textField

The primary account holder's country, in ISO 3166-1 alpha-2 format, such as "US".

Account Email textField

The primary account holder's email address.

Account Work Phone textField

The primary account holder's work telephone number. This field is not an entity.

Date of Birth textField

The primary account holder's date of birth, formatted as YYYYMMDD.

Gender textField

The primary account holder's gender.

National ID Number textField

The primary account holder's national ID number. Used for identity verification.

National ID Type dropDown

The primary account holder's national ID type. Used for identity verification.

  • US SSN
  • US SSN HASH
  • US SSN4
  • US SSN FIRST5
  • BR CPF
  • MX CURP
  • CO CEDULA
Driver License Number textField

The primary account holder's driver license number.

Driver License Issuer textField

Primary account driver license issuer

Routing Address textField

The primary account holder's routing address.

Routing Standard textField

The primary account holder's routing standard.

Account Number textField

The primary account holder's account number.

Passport Number textField

The primary account holder's passport number.

Passport machine Readable Line 1 textField

The primary account holder's passport information in machine-readable format, line 1.

Passport machine Readable Line 2 textField

The primary account holder's passport information in machine-readable format, line 2.

Passport Expiration Date textField

The primary account holder's passport expiration date, formatted as YYYY-MM-DD.

Passport Country textField

The primary account holder's passport country, in ISO 3166-1 alpha-2 format, such as “US”.

Transaction ID textField

The identifier used by the merchant to identify the transaction, such as a purchase order number.

Credit Card Number textField

The credit card number used in the transaction.

Online TLD textField

The description of the online TLD handle source. Used to prevent collisions between different online TLD handles. For help determining the correct online TLD for the ID you wish to send with your query, speak to a LexisNexis representative. This field is required if the Online TLD Handle field is populated.

Online TLD Handle textField

A unique third-party identifier, such as a LexID or a DUNS Number. Used for rule creation and investigation. This field is required if the Online TLD field is populated.

Line of Business textField

The line of business specified by the customer.

Application Name textField

The name of the application sending the event.

Shipping Account Holder's Street Address 1 textField

The shipping account holder's street address, line 1.

Shipping Account Holder's Street Address 2 textField

The shipping account holder's street address, line 2.

Shipping Account Holder's City textField

The shipping account holder's city.

Shipping Account Holder's State textField

The shipping account holder's state.

Shipping Account Holder's ZIP or Postal Code textField

The shipping account holder's ZIP or postal code.

Shipping Account Holder’s Country textField

The shipping account holder's country, in ISO 3166-1 alpha-2 format, such as “US”.

Routing Number textField

The routing number for the account. When using this attribute in a Condition/Expression Condition rule or Expression variable, the value will be treated as a string if quotes are used to enclose it and as a number if no quotes are used.

Transaction Amount textField

The numeric currency amount. If a decimal is used, exactly two digits must follow it.

Transaction Currency textField

The currency used for the transaction, formatted in ISO 4217 currency code, such as “USD”. This field is required when Transaction Amount is populated.

Account Login textField

A unique identifier for the customer, such as a username or account ID. Used to check whether the customer is on a watch list.

Password textField

The password associated with the Account Login. This is hashed and sent to LexisNexis. Used to check whether the customer is on a watch list.

Social Security Number textField

The customer's social security number.

Account Number (Hash) textField

The customer's account number. This is hashed and sent to LexisNexis.

Driver License Number (Hash) textField

The customer's driver license number. This is hashed and sent to LexisNexis.

IP Address textField

The customer's IP address as detected by a web server. This must be a valid external address.

Page FingerPrint textField

The page fingerprint. This is hashed and sent to LexisNexis.

Device ID textField

The ExactID persistent global identifier, which relies on a variety of persistent markers (browser cookies, Adobe Flash cookies, HTML 5 local storage) to allow ThreatMetrix to 100% accurately identify a device.

Fuzzy Device ID textField

The SmartID device identifier, which is cookieless, and is based exclusively on device attributes to improve detection of returning visitors, especially those trying to elude identification, and reduces false positives.

HTTP Referer Domain textField

For TD Cloud, the domain of the HTTP referrer detected during profiling. For TD Mobile, this field can be optionally populated by the ‘Custom URL’ option in the TrustDefender Mobile Library. This relates to the Profiled Domain property below but only includes the domain portion of the passed URL as opposed to the whole URL which is present in the Profiled Domain property. This is passed to the library by the customer’s native application. Described in more detail in the TMX Knowledgebase, Article ID 378.

Profiled Domain textField

For TD Cloud, the URL (i.e. domain + path + querystring) of the referring page. For TD Mobile, the same as the HTTP Referer Domain property.

Input Schema
default object
apiUrl string required
apiKey string required
orgId string required
service_type string required
account_first_name string
account_middle_name string
account_last_name string
account_address_street1 string
account_address_street2 string
account_address_city string
account_address_state string
account_address_zip string
account_address_country string
account_email string
account_telephone string required
account_work_phone string
account_date_of_birth string
account_gender string
account_national_id_number string
account_national_id_type string
account_drivers_license_number string
account_drivers_license_issuer string
account_routing_address string
account_routing_standard string
account_number string
account_passport_number string
account_passport_machine_readable_line1 string
account_passport_machine_readable_line2 string
account_passport_expiration_date string
account_passport_country string
transaction_id string
cc_number_hash string
online_tld string
online_tld_handle string
line_of_business string
application_name string
shipping_account_address_street1 string
shipping_account_address_street2 string
shipping_account_address_city string
shipping_account_address_state string
shipping_account_address_zip string
shipping_account_address_country string
ach_routing_number string
transaction_amount number
transaction_currency string
account_login string
password_hash string
ssn_hash string
ach_account_hash string
drivers_licence_number_hash string
input_ip_address string
page_fingerprint string
device_id string
fuzzy_device_id string
http_referer_domain string
profiled_domain string
Output Schema
output object
rawResponse object
properties object
account_address_city string
account_address_state string
account_address_street1 string
account_address_zip string
account_date_of_birth string
account_first_name string
account_last_name string
account_lex_id string
account_lex_id_region string
account_telephone string
account_telephone_is_possible string
account_telephone_is_valid string
account_telephone_type string
api_call_datetime string
api_type string
api_version string
champion_request_duration string
event_datetime string
event_type string
integration_hub_results object
properties object
3c8qvza7:Phone Finder object
properties object
Execute Phone Finder object
properties object
rule_id string
tps_datetime string
tps_duration string
tps_result string
tps_type string
tps_vendor string
tps_vendor_raw_response object
properties object
Status object
properties object
ConversationId string
RequestId string
TransactionStatus string
Products array
items array
type object
properties
tps_was_timeout string
national_id_number string
national_id_type string
org_id string
policy string
policy_details_api object
properties object
policy_detail_api array
items array
type object
properties {"type":"string"}
policy_engine_version string
policy_score string
reason_code array
items array
type string
request_id string
request_result string
review_status string
risk_rating string
service_type string
tps_was_timeout string
Emailage

Evaluate email address metadata points such as domain details, email details, risk indicators, and other PII.

Details
Details
Properties
Email textField

Email of the user

IP Address textField

IP Address of the user

First Name textField

The customer's first name.

Last Name textField

The customer's last name.

Phone textField

The customer's phone number, including area code and local exchange. This is used to verify that the customer's phone number is in the same billing location as the cardholder. Most formats are accepted, but ISO E.164 format is highly recommended.

Secondary Email textField

If an additional email is available for the transaction, it is sent under this input field. Example: For money transfers, this is the recipient’s email. NOTE: We do not provide a score for this email. It is mainly used as supporting data for risk assessment, similar to phone, address, name, etc.

Is Existing Customer? toggleSwitch

Indicates if the customer is a repeat customer.

Customer ID textField

This parameter can be used as an unique identifier for the customer.

Tracking ID textField

The trackingId associated with the original scoring request. This parameter can be used when you want to add an internal system identifier for a query. This identifier will be returned with the results.

Partner ID textField

ID used to identify an Emailage Partner.

Customer Identifier textField

ID used to identify an Emailage Partner’s customer.

Billing Address textField

The billing address for the customer.

Billing City textField

The billing city for the customer.

Billing State or Region textField

The billing state or region for the customer.

Billing Postal Code textField

The billing postal (ZIP) code for the customer.

Billing Country textField

The billing country for the customer. This can be passed as the full country name or as an ISO 3166-1 alpha-2

Shipping Address textField

The shipping address for the customer.

Shipping City textField

The shipping city for the customer.

Shipping State or Region textField

The shipping state or region for the customer.

Shipping Postal Code textField

The shipping postal (ZIP) code for the customer.

Shipping Country textField

The shipping country for the customer. This can be passed as the full country name or as an ISO 3166-1 alpha-2

Card First 6 textField

The first six digits of a bank card number or payment card number and it is part of ISO/IEC 7812. Used to identify a card brand, issuing institution or bank, country of issuance, card type, and category of cards.

Transaction Amount textField

The customer's transaction amount.

Transaction Currency textField

The currency used for the customer's transaction as an ISO 4217 code.

Transaction Origin textField

Indicates who initiated the transaction. Inbound is where the customer initiates the transaction, and outbound is where the company initiated the transaction.

User Record ID textField

This is a user defined Record ID. This parameter can be used when you want to add an identifier for a query. This identifier will be returned with the results.

Transaction Type ID dropDown

The Transaction Type ID of the event being scored. Can be used instead of the transactionTypeDescription. Do not enter both the transactionTypeId and the transactionTypeDescription.

  • Account creation
  • Account login
  • Email change
  • Password reset
  • Purchase
  • Recurring purchase
  • Referral
  • Survey
  • Job posting
  • Job application
  • Promotions
  • Payment
  • Banking
  • Digital
  • Comment
  • Insurance
  • Transaction Other
Transaction Type Description dropDown

The Transaction Type Description of event being scored. Can be used instead of the transactionTypeId. Do not enter both the transactionTypeId and the transactionTypeDescription.

  • Account creation
  • Account login
  • Email change
  • Password reset
  • Purchase
  • Recurring purchase
  • Referral
  • Survey
  • Job posting
  • Job application
  • Promotions
  • Payment
  • Banking
  • Digital
  • Comment
  • Insurance
  • Transaction Other
Time of Service textField

Number of days until service.

Service Date textField

The date and time of the service. Examples: Traveling - Date of flight, Hospitality - Date of stay, Ticketing - Date of event, Technology/Finance/eCommerce - Date of the service. Date/time parameter must be specified in UTC (Zulu) and be formatted in the ISO8601 style as below: yyyy-mm-ddThh:mm:ssZ (e.g: 2008-09-15T15:53:00Z)

Service Location textField

The location of the final service/transaction.

Service Details textField

Further detail of the service or transaction.

Service Category textField

The general category of the service

Delivery Type textField

The type of delivery of the goods or service.

Useragent textField

The User-Agent HTTP header.

Device ID textField

Vendor code representing the device ID manufacturer used to determine the device ID. NOTE: Send only the 3 digit code. The vendor codes are as follows: 100 - Emailage 110 - 41st Parameter 120 - ThreatMetrix 130 - Iovation 140 - RiskFort 150 - DigitalResolve 160 - RSA 170 - Symantec (Verisign) 180 - Nudata 190 - Kount 200 - InAuth 990 - Other

Device Source textField

Vendor code representing the device ID manufacturer used to determine the device ID. NOTE: Send only the 3 digit code. The vendor codes are as follows: 100 - Emailage 110 - 41st Parameter 120 - ThreatMetrix 130 - Iovation 140 - RiskFort 150 - DigitalResolve 160 - RSA 170 - Symantec (Verisign) 180 - Nudata 190 - Kount 200 - InAuth 990 - Other

User Email textField

The Emailage username used to make the query. By default, if user_email is not specified, we use the account's default user and the associated department. If this value is applied, we use the specified user and department. NOTE: This is NOT the email address being queried. If this field is populated with an email other than one authorized to run queries, 3001 errors will be generated

accept-language HTTP header textField

The accept-language HTTP header (Language Culture Name).

Response Language textField

The language returned in the API response.

Input Schema
default object
apiUrl3 string required
clientId string required
clientSecret string required
email string required
ip string
firstname string
lastname string
phone string
secondary_email string
existingcustomer boolean
customerid string
trackingId string
partnerid string
customeridentifier string
billaddress string
billcity string
billregion string
billpostal string
billcountry string
shipaddress string
shipcity string
shipregion string
shippostal string
shipcountry string
cardFirstSix string
transamount string
transcurrency string
transorigin string
urid string
transactionTypeID string/number
transactionTypeDescription string
time_to_service string
service_date string
service_location string
service_detail string
service_category string
delivery_type string
useragent string
deviceid string
devicesource string
user_email string
acceptlang string
response_language string
Output Schema
output object
rawResponse object
properties object
query object
properties object
email string
queryType string
count integer
created string
lang string
responseCount integer
firstname string
lastname string
phone string
billaddress string
billcity string
billregion string
billpostal string
billcountry string
results array
items array
type object
properties
responseStatus object
properties object
status string
errorCode string
description string
Knowledge-Based Authentication

Challenge users with knowledge-based questions.

Details
Details
Properties
Mode dropDown

Mode in which the transaction should run

  • live
  • testing (Default)
  • simulated
Locale dropDown

Language in which the customer wants to receive the response

  • US English
  • Formal Spanish
  • Haitian Creole (only for authentication
First Name textField

The primary account holder's first name.

Middle Name textField

The primary account holder's middle name

Last Name textField

The primary account holder's last name

Telephone Number textField

The primary account holder's telephone number. Can contain the following characters: 0-9 , . ; { } ( and ). All braces must be in pairs. White space is removed automatically.

Account Email textField

The primary account holder's email address.

Street Address 1 textField

The primary account holder's street address 1

Street Address 2 textField

The primary account holder's street address 2

City textField

The primary account holder's city

State textField

The primary account holder's State

ZIP textField

The primary account holder's ZIP

Country textField

The primary account holder's country, in ISO 3166-1 alpha-2 format, such as "US".

SSN textField

Social Security Number

SSN Type dropDown

Type of SSN provided

  • ssn4
  • ssn9
  • ssn-first5
  • nossn
  • other
Day of Birth textField

Day (DD) Possible values are 1 – 31 .

Month of Birth textField

Month (MM) Possible values are numbers 1 – 12 .

Year of Birth textField

Year of Birth (YYYY) e.g. 1985, 1958, 2001

Lex ID textField

Unique identifier that is assigned to a subject by LexisNexis®. A LexID® number does not include any SPII (sensitive personally identifiable information). Either the LexID number or the indicated name elements are required.

Simulation Mode dropDown

An element that governs the response given by RDP This element is required only when Mode is set to simulated .

  • Random
  • Error Simulation Values
  • Communications Error
  • Internal Application_Error
  • Invalid Information
  • Invalid Login
  • Invalid Mode
Reference textField

Internal tracking number that your organization can assign to a transaction.

GLBA textField

Integer value based on the GLBA (Gramm-Leach-Bliley Act) that indicates the reason for the request

DPPA textField

Integer value pursuant to the DPPA (Driver’s Privacy Protection Act) of 1994 that indicates the reason for the request

Venue dropDown

Type of environment where the transaction takes place

  • online
  • callcenter
  • batch
  • point-of-sale
  • customer-service
  • ivr
Use Custom Screens toggleSwitch
Input Schema
default object
apiUrl2 string required
username string required
password string required
accountId string required
settingsMode string required
SimulationType string
Reference string
GLBA string
DPPA string
Locale string required
Venue string
LexID string
day string
month string
year string
account_first_name string
account_middle_name string
account_last_name string
account_address_street1 string
account_address_street2 string
account_address_city string
account_address_state string
account_address_zip string
account_address_country string
account_email string
account_telephone string
ssnNumber string
ssnType string
Output Schema
output object
rawResponse object
properties object
Status object
properties object
ConversationId string
RequestId string
TransactionStatus string
TransactionReasonCode object
properties object
Code string
LexID string
Products array
items array
type object
properties
required ProductType/ExecutedStepName/ProductConfigurationName/ProductStatus/Items
One Time Password

Send a one-time password.

Details
Details
Properties
Delivery method for the OTP dropDown

Delivery method for the OTP

  • Text
  • Email
SMS Body textField

Defines the custom SMS text body.

Default:

Your One Time Password is ${OTP}.${LineBreak}We will never call you for this code.${LineBreak}Your passcode will expire in ${ExpirePeriod} minutes
Email Title textField

Defines the custom OTP Email Header.

Default:

Please, check out this email! It's your one time passcode!
Email Title textField

Defines the custom OTP Email Body.

Default:

Your One Time Passcode is ${OTP}.${LineBreak}We will never call you for this code.${LineBreak}Your passcode will expire in ${ExpirePeriod} minutes
Delivery language for the OTP message dropDown

Delivery language for the OTP message

  • English
  • French
  • Spanish
Telephone Number textField

The primary account holder's telephone number. Can contain the following characters: 0-9 , . ; { } ( and ). All braces must be in pairs. White space is removed automatically.

Account Email textField

The primary account holder's email address.

First Name textField

The primary account holder's first name.

Middle Name textField

The primary account holder's middle name

Last Name textField

The primary account holder's last name

Date of Birth textField

The primary account holder's date of birth, formatted as YYYYMMDD.

Gender textField

The primary account holder's gender.

Street Address 1 textField

The primary account holder's street address 1

Street Address 2 textField

The primary account holder's street address 2

City textField

The primary account holder's city

State textField

The primary account holder's State

ZIP textField

The primary account holder's ZIP

Country textField

The primary account holder's country, in ISO 3166-1 alpha-2 format, such as "US".

National ID Number textField

The primary account holder's national ID number. Used for identity verification.

National ID Type dropDown

The primary account holder's national ID type. Used for identity verification.

  • US SSN
  • US SSN HASH
  • US SSN4
  • US SSN FIRST5
  • BR CPF
  • MX CURP
  • CO CEDULA
Telephone Context textField

The context of the telephone, for e.g.: Mobile

Telephone GEO textField

Telephone geolocation, for e.g.: US

Event Type dropDown

NOTE: If event_type is passed to attribute query, it WILL increment velocity counters etc just like a session query. if there is no event_type on attribute query, it will run but not increment velocity etc counters.

  • Login
  • Payment
  • Account Creation (Default)
  • Transfer
  • Transaction Other
  • Auction Bid
  • Details Change
  • Add Listing
  • Account Balance
  • Transaction History
  • Digital Download
  • Digital Stream
Use Custom Screens toggleSwitch
Input Schema
default object
apiUrl4 string required
orgId2 string required
apiKey2 string required
event_type string
Method string required
SmsBody string
EmailTitle string
EmailBody string
Language string required
account_first_name string
account_middle_name string
account_last_name string
account_date_of_birth string
account_gender string
account_address_street1 string
account_address_street2 string
account_address_city string
account_address_state string
account_address_zip string
account_address_country string
account_national_id_number string
account_national_id_type string
account_email string
account_telephone string
account_telephone_context string
account_telephone_geo string
complete object
apiUrl4 string required
orgId2 string required
apiKey2 string required
Method string required
Language string required
Output Schema
output object
rawResponse object
properties object
account_address_country string
account_email string
account_email_activities array
items array
type string
account_email_attributes array
items array
type string
account_email_first_seen string
account_email_last_event string
account_email_last_update string
account_email_result string
account_email_score string
account_email_worst_score string
account_first_name string
account_last_name string
account_middle_name string
account_name_activities array
items array
type string
account_name_attributes array
items array
type string
account_name_first_seen string
account_name_last_event string
account_name_last_update string
account_name_result string
account_name_score string
account_name_worst_score string
action string
action_template string
api_call_datetime string
api_caller_ip string
api_type string
auth_method string
auth_status string
champion_request_duration string
enabled_services array
items array
type string
event_date string
event_datetime string
event_last_update string
event_type string
input_request_id string
integration_hub_results object
properties object
11jr7q70:Authentication object
properties object
Authentication object
properties object
rule_id string
tps_datetime string
tps_duration string
tps_error string
tps_result string
tps_type string
tps_vendor string
tps_vendor_raw_response object
properties object
Status object
properties object
ConversationId string
RequestId string
TransactionStatus string
Reference string
InputEcho array
items array
type object
properties
Products array
items array
type object
properties
tps_was_timeout string
national_id_type null
org_id string
original_event_created string
original_event_updated string
policy string
policy_details_api object
properties object
policy_detail_api array
items array
type object
properties {"type":"string"}
policy_engine_version string
policy_score string
primary_industry string
reason_code array
items array
type string
request_duration string
request_id string
request_id_activities array
items array
type string
request_result string
review_status string
risk_rating string
secondary_industry string
service_type string
summary_risk_score string
tmx_reason_code array
items array
type string
tmx_risk_rating string
tps_datetime string
tps_duration string
tps_error string
tps_result string
tps_type string
tps_vendor string
tps_vendor_raw_response string
tps_was_timeout string
Knowledge-Based Authentication (Authentication Project)

Challenge users with knowledge-based questions.

Details
Details
Properties
First Name textField

The primary account holder's first name.

Middle Name textField

The primary account holder's middle name

Last Name textField

The primary account holder's last name

Telephone Number textField

The primary account holder's telephone number. Can contain the following characters: 0-9 , . ; { } ( and ). All braces must be in pairs. White space is removed automatically.

Account Email textField

The primary account holder's email address.

Date of Birth textField

The primary account holder's date of birth, formatted as YYYYMMDD.

Gender textField

The primary account holder's gender.

Street Address 1 textField

The primary account holder's street address 1

Street Address 2 textField

The primary account holder's street address 2

City textField

The primary account holder's city

State textField

The primary account holder's State

ZIP textField

The primary account holder's ZIP

Country textField

The primary account holder's country, in ISO 3166-1 alpha-2 format, such as "US".

National ID Number textField

The primary account holder's national ID number. Used for identity verification.

National ID Type dropDown

The primary account holder's national ID type. Used for identity verification.

  • US SSN
  • US SSN HASH
  • US SSN4
  • US SSN FIRST5
  • BR CPF
  • MX CURP
  • CO CEDULA
Telephone Context textField

The context of the telephone, for e.g.: Mobile

Telephone GEO textField

Telephone geolocation, for e.g.: US

Event Type dropDown

NOTE: If event_type is passed to attribute query, it WILL increment velocity counters etc just like a session query. if there is no event_type on attribute query, it will run but not increment velocity etc counters.

  • Login
  • Payment
  • Account Creation (Default)
  • Transfer
  • Transaction Other
  • Auction Bid
  • Details Change
  • Add Listing
  • Account Balance
  • Transaction History
  • Digital Download
  • Digital Stream
Use Custom Screens toggleSwitch
Input Schema
default object
apiUrl4 string required
orgId2 string required
apiKey2 string required
event_type string
account_first_name string
account_middle_name string
account_last_name string
account_date_of_birth string
account_gender string
account_address_street1 string
account_address_street2 string
account_address_city string
account_address_state string
account_address_zip string
account_address_country string
account_national_id_number string
account_national_id_type string
account_email string
account_telephone string
account_telephone_context string
account_telephone_geo string
Output Schema
output object
rawResponse object
properties object
account_address_city string
account_address_country string
account_address_state string
account_address_street1 string
account_email string
account_first_name string
account_last_name string
auth_method string
auth_status string
event_datetime string
event_type string
answers object
properties object
QuestionSetId string
Questions array
items array
type object
properties
input_request_id string
original_event_created string
original_event_updated string
policy string
policy_engine_version string
policy_site_id string
request_duration string
request_id string
request_result string
review_status string
TrueID: Verify Document

Verify user identities with government ID validation and selfie liveness checks.

Details
Details
Properties
Mode dropDown

Mode in which the transaction should run

  • live
  • testing (Default)
  • simulated
Locale dropDown

Language in which the customer wants to receive the response

  • US English
  • Formal Spanish
  • Haitian Creole (only for authentication
Simulation Mode dropDown

An element that governs the response given by RDP This element is required only when Mode is set to simulated .

  • Random
  • Error Simulation Values
  • Communications Error
  • Internal Application_Error
  • Invalid Information
  • Invalid Login
  • Invalid Mode
Venue dropDown

Type of environment where the transaction takes place

  • online
  • callcenter
  • batch
  • point-of-sale
  • customer-service
  • ivr
Workflow dropDown

Type of workflow

  • ID (Default)
  • ID + Selfie
Use Custom Screens toggleSwitch
Input Schema
default object
trueIdUsername string
trueIdPassword string
acasEndpoint string
acuantJavascriptWebSdkScriptSource string
acuantConfigurationScript string
acuantJavascriptWebSdkScript string
acuantCameraScript string
acuantPassiveLivenessScript string
openCvScript string
apiUrl2 string
username string
password string
accountId string
settingsMode string
SimulationType string
Reference string
Locale string
Venue string
workflowType string
Output Schema
output object
rawResponse object
properties object
Status object
properties object
ConversationId string
RequestId string
TransactionStatus string
Products array
items array
type object
properties
frontImageFileName string
backImageFileName string
selfieImageFileName string
TrueID: Delete Document

Delete government documents from LexisNexis.

Details
Details
Properties
Delete Front Image dropDown
  • Yes (Default)
  • No
Delete Back Image dropDown
  • Yes (Default)
  • No
Delete Selfie Image dropDown
  • Yes (Default)
  • No
Input Schema
default object
deleteFrontImage string
deleteBackImage string
deleteSelfieImage string
Output Schema
output object
rawResponse object
properties object
frontImageDeleted boolean
backImageDeleted boolean
selfieImageDeleted boolean