How to Implement Ekata Data in Command

Command integrates with Ekata, a global identity verification data service provider. The Ekata Identity Engine™ powers the Ekata API that provides additional data points in the Command Agent Web Console (AWC). The Ekata Identity Engine validates Personal Identifiable Information (PII or Identity Elements) and analyzes how they behave in digital interactions.

Once integrated, customers can access the Ekata gadget on the Transaction Details page in the AWC. Our customers who are looking for additional information to verify order information can utilize the Ekata data outputs and integrated rules-based API. The single-service validates key data points:

Email Address
Phone Number
IP Address
Physical Address

These data points can be used in our real-time Auto Decision Engine (ADE), Auto Agent (AA), and for manual review.

Ekata in the AWC

Ekata is integrated into two major components of Command: Transaction Details and Rules Engine. Ekata data is visible in the following locations:

Transaction Details

Order Details gadget for quick review of available information
Ekata details view
Display rules triggered related to Ekata
Deep linking available

Rules Engine

Automated real-time API call to Ekata
Select all orders or filter for individual orders based on over 300 data elements
Auto Agent callout for use cases that do not require instant results
Feed data into case management system
Create complex scorecards

Ekata checks return many different categories of response data for both North American (U.S. and Canada) and international identity checks, including:

Ekata Phone Check Responses
Ekata Billing and Shipping Address Check Responses
Ekata IP Address Check Responses
Ekata Email Address Check Responses

Ekata Gadget

Once integrated, the Ekata gadget displays on the Transaction Details page.

Ekata Identity Check Score and Identity Network Score charts

Data is identifiable via three status types: pass, warning, and neutral.

Data rules that are examined and demonstrate no issues are marked with the pass icon, a check inside a green circle.
Data rules that are examined and demonstrate a potential problem are marked with a warning icon, an exclamation point inside a yellow triangle.
Any rules examined that return no icon indicate that information is not available for the given data type or that the examination did not yield information that warrants a pass or warning.

Select more data in the Ekata gadget for additional information.

Rules can be written in both the Real-Time Rules Engine and the Auto Agent Rules Engine using Ekata data. If a rule involving Ekata has been written and triggered, that information displays in the Rules Triggered gadget on the Transaction Details page.

Ekata Data

Ekata receives inputs for the billing and shipping name, address, and phone, then returns a different set of outputs depending on if the data is from North America or is International.

North American Data

In North America, the focus is on matching data elements to a consumer identity. The identity coverage is for phones, emails, and addresses in the United States and Canada.

Billing and Shipping Phone	Billing and Shipping Address	Email	IP Address
Phone to Name Match	Address to Name Match	Email-to-Name Match	Distance to Address
Phone to Address Match	Address Type	Warnings	Distance to Phone Location
Line Type	Warnings	First Seen Date	Geolocation
Carrier	Diagnostics	Domain Creation Date	Warnings
Country Code	Is Valid	Is Valid	Is Valid
Is Valid	Is Commercial	Is Auto Generated	Is Proxy
Is Prepaid		Is Disposable
Is Commercial

International Data

Ekata returns data for over 160 different countries worldwide. The focus is on providing a broad and consistent response for almost every country worldwide. The Ekata integration validates phones and addresses and returns rich intelligence on the email and IP address associated with a transaction. The international offering is primarily used to push risky orders into the manual review queue by looking at strong risk signals like invalid phones and addresses. But it can also be used to write rules for the Auto Decision Engine (ADE) and Auto Agent (AA).

Billing and Shipping Phone	Billing and Shipping Address	Email	IP Address
Phone to Address Match	Warnings	Email to Name Match	Distance to Address
Line Type	Diagnostics	Warnings	Distance to Phone Location
Carrier	Is Valid	First Seen Date	Geolocation
Country Code		Domain Creation Date	Warnings
Is Valid		Is Valid	Is Valid
		Is Auto Generated	Is Proxy
		Is Disposable

Ekata Identity Risk Score Responses

The Identity Check Score and Identity Network Score provide a snapshot into how risky a transaction might be, according to the Ekata five-in-one identity verification process.

The Identity Check Score ranges from 0-500. 0 is the least risky and 500 is the most risky. The Identity Network Score ranges from 0-1, 0 being the least risky and 1 being the most risky. Identity risk score responses are generated and continuously optimized by the Ekata Identity Engine that leverages millions of transactional patterns across the Ekata network. The responses are also generated by the 5B global links connecting names, phones, addresses, email, and IP data.

Note

Identity risk score responses are generated for all domestic transactions. They display as No Score Available for transactions with international addresses.

High Callouts Alert

A high callouts alert means we identified an unusual surge in Ekata usage within your merchant account. If this is unexpected behavior, contact your Customer Success Manager.

To view your current and previous Ekata usage rates, create a report in Datamart where the true column indicates that an Ekata callout was initiated.

Note

Ekata callouts are controlled by the Rules Engine, which allows you to use Ekata on all orders or selectively based on over 300 data elements. For more information on managing Rules in the AWC, refer to the How to Manage Rules in the Agent Web Console.

Additional Information

Ekata Phone Check Responses

For phone check responses, Ekata considers the inputs Primary Phone, Primary Address, Primary Name (or Primary First Name and Primary Last Name), Secondary Phone, Secondary Address, Secondary Name (or Secondary First Name and Secondary Last Name).

Error: An error message for a phone check can return the following responses:

Null – No information returned
Partial Error – Could not retrieve entire response
International Phone Disabled – Phone number is international and international phone checks are turned off in your API key

Warnings: A warning message returns the following:

Invalid Input
Not Found
Empty Array

Is Valid: This indicates if the phone is a valid phone number and is assigned to a carrier:

True
False
Null

Phone to Name: A verification result whether the subscriber name for the phone matches the input name:

Match – Positive indicator
No Match – Increased risk
No Name Found
Null

Phone to Address: A verification result whether the phone matches the input address:

Match – Positive indicator
Postal Match
Zip Code +4 Match
City/State Match
No Match – Increased risk but can also be the result of family plans or phones belonging to a business
Null

Subscriber Name: Returns the name of the input phone if available.

Country Code: Returns a country code for input phone such as U.S. Increased risk if the country code does not match subscribers input address.

Is Commercial: Indicates if the phone is registered to a business:

True
False
Null

Line Type: The line type for the input phone:

Mobile
Landline
Fixed VOIP
Non-fixed VOIP – Not fixed to a physical address. Increased risk; compare to other indicators
Premium
Toll free – Increased risk; compare to other indicators
Voicemail
Other
Unknown

Carrier: Returns the name of the carrier such as Verizon.

Is Prepaid: Indicates if the phone is registered to a business:

True – Indicator of increased risk in most cases
False
Null

Ekata Billing and Shipping Address Check Responses

For address check responses, Ekata considers the inputs Primary Address and Primary Name (or Primary First Name and Primary Last Name) and Secondary Address and Secondary Name (or Secondary First Name and Secondary Last Name).

Error: An error message for an address check can return the following responses:

Null – No information returned
Partial Error – Could not retrieve entire response
International Address Disabled – Address is international and international address checks are turned off in your API key

Warnings: A warning message returns the following:

Invalid Input
Invalid Country Code
Missing Unit/Apt/Suite Number
Invalid Unit/Apt/Suite Number
Not Found
Empty Array

Is Valid: This indicates if the address is a valid address:

True
False
Null

Phone to Name: A verification result whether the subscriber name for the phone matches the input name:

Match – Positive indicator
No Match – Increased risk
No Name Found
Null
Validated
Validated only Street, Postcode, City, Country; premise not validated
Validated only Postcode, City, Country
Validated only City, Country
Validated only Country
Added – A valid response not often seen but possible.
Building, PO Box or Company exists; premise number incorrect or not validated – A valid response not often seen but possible
Could not recognize address – A valid response not often seen but possible
Premise empty – A valid response not often seen but possible
Some corrections made – A valid response not often seen but possible

Address to Name: A verification result whether the resident name for the phone matches the input name:

Match – Positive indicator
No Match – Increased risk; compare to other indicators
No Name Found
Null

Resident Name: Returns the name of the resident of the input address.

Is Commercial: Indicates if the address is registered to a business:

True
False
Null

Type: The delivery point for the address:

Commercial mail drop – Indicates increased risk
Multi unit
Single unit
PO Box – Indicates increased risk
PO Box Throwback – Indicates increased risk
Unknown address type

Ekata IP Address Check Responses

For IP address check responses, Ekata considers the following inputs:

IP Address
Primary/Secondary Address
Primary/Secondary Phone

Error: An error message for an address check can return the following responses:

Null – No information returned
Partial Error – Could not retrieve entire response

Warnings: A warning message returns the following:

Invalid Input
IP address is in a private range – The IP address cannot be routed across the internet indicating a higher risk
Empty array

Is Valid: This indicates if the IP address is valid:

True
False
Null

Is Proxy: This indicates if the IP address is a known proxy:

True – This indicates the possibility of a higher risk
False
Null

IP Geolocation: This includes the location of the IP address providing:

Postal code
City name – such as Boise
Country name – such as United States
Continent Code – such as NA

Ekata Email Address Check Responses

Ekata can provide email check response types by considering the following inputs:

Email Address and Primary Name (or Primary First Name and Primary Last Name)
Email Address and Secondary Name (or Secondary First Name and Secondary Last Name)

Potential Responses:

The mailbox is invalid or does not exist
Timeout
General syntax error
Invalid character in address
Invalid domain syntax
Invalid username syntax
Invalid username syntax for that domain
Address is too long
Address has unbalanced parentheses, brackets, or quotes
Address does not have a username
Address does not have a domain
Address does not have an @ sign
Address has more than one @ sign
Invalid top-level-domain (TLD) in address
IP address not allowed as a domain
Comments are not allowed in email addresses
Unquoted spaces are not allowed in email addresses
Domain does not exist
Domain does not have a valid IP address
Domain cannot receive email
The mailbox is invalid or the username does not exist at the domain
Mailbox is full and cannot receive email at this time
Mail is not accepted for this domain
Addresses with that username are not allowed
Addresses with that domain are not allowed
Address is a bot or other suppression
Address is a role-based account
Address is a known bouncer
Address is a spamtrap or known complainer
Address has opted out from commercial email
Internal error

Is Valid: This indicates if the email address is valid and emails can be delivered there:

True
False
Null

Is Autogenerated: This indicates if the email is possibly autogenerated:

True – Indicates a higher risk and other indicators should be examined
False
Null

Is Disposable: This indicates if the email domain is disposable:

True – Disposable email domains cannot receive email and indicate a higher risk for fraud
False
Null

Email to Name: A verification result whether the registered name for the email address matches the input name:

Match – Positive indicator
No Match – Increased risk, compare to other indicators before weighting
No Name Found
Null

Registered Name: Returns the registered name of the email address owner.

Frequently Asked Questions

What if I already have an agreement with Ekata?

Ekata is an optional third-party integration into the AWC that allows multiple identity checks of an end customer with a single action. Customers who have a relationship with Ekata may use this option if they wish to continue to be billed directly by Ekata directly while using the service via the AWC.

Acquire an API key from Ekata, and then paste it into the API Key field.
Click Test Key to verify that the key is valid.
Click Save Key.

Ekata in the AWC

Transaction Details

Rules Engine

Ekata Gadget

Ekata Data

North American Data

International Data

Ekata Identity Risk Score Responses

Note

High Callouts Alert

Note

Additional Information

Frequently Asked Questions

Comments

Can’t find what you’re looking for?

Contact Us

Ekata in the AWC

Transaction Details

Rules Engine

Ekata Gadget

Ekata Data

North American Data

International Data

Ekata Identity Risk Score Responses

Note

High Callouts Alert

Note

Additional Information

Frequently Asked Questions

Related articles

Can’t find what you’re looking for?

Contact Us