When you post Risk Inquiry Service (RIS) information to Kount, a key-value pair string is returned (RIS response). The RIS response format is the same that was specified in the RIS post, with the default being named pairs. Each data field must be invoked by "getter" methods on the response object found in the SDK. You can automate the order management process by keying off the AUTO field and then utilize any of the additional data returned for internal processing.
You can use the RIS response to verify the Device Data Collection (DDC) process was successful and view any warnings or errors that were made during the RIS post. The KAPT field is used to determine if the DDC process was successful. KAPT=Y means successful and KAPT=N means the process was unsuccessful. All warnings are displayed in the response and if errors occur, the RIS response is returned with a MODE=E.
RIS Response JSON
{
"VERS": "0700",
"MODE": "Q",
"TRAN": "76JG032JT7CD",
"MERC": "888889",
"SESS": "f2d209d0d4cf4c37b0481ff3adcbde00",
"ORDR": "ORDR-1567540565",
"AUTO": "A",
"SCOR": "28",
"GEOX": "US",
"BRND": "VISA",
"REGN": "US_ID",
"NETW": "N",
"KAPT": "Y",
"CARDS": "1",
"DEVICES": "1",
"EMAILS": "1",
"VELO": "0",
"VMAX": "0",
"SITE": "DEFAULT",
"DEVICE_LAYERS": "DF651ACF30..99CF09F417.E3D16F2CB7.061826EF2B",
"FINGERPRINT": "290D1C0172364AADAC25D9FD0B13D946",
"TIMEZONE": "360",
"LOCALTIME": "2019-09-03 13:56",
"REGION": "US_ID",
"COUNTRY": "US",
"PROXY": "N",
"JAVASCRIPT": "Y",
"FLASH": "N",
"COOKIES": "Y",
"HTTP_COUNTRY": "US",
"LANGUAGE": "EN",
"MOBILE_DEVICE": "N",
"MOBILE_TYPE": null,
"MOBILE_FORWARDER": "N",
"VOICE_DEVICE": "N",
"PC_REMOTE": "N",
"RULES_TRIGGERED": "0",
"COUNTERS_TRIGGERED": "0",
"REASON_CODE": null,
"DDFS": "2019-08-22",
"DSR": "1050x1680",
"UAS": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/76.0.3809.100 Safari/537.36",
"BROWSER": "Chrome 76.0.3809.100",
"OS": "Mac OS X 10.14.6",
"PIP_IPAD": null,
"PIP_LAT": null,
"PIP_LON": null,
"PIP_COUNTRY": null,
"PIP_REGION": null,
"PIP_CITY": null,
"PIP_ORG": null,
"IP_IPAD": "208.75.113.3",
"IP_LAT": "43.6337",
"IP_LON": "-116.2004",
"IP_COUNTRY": "US",
"IP_REGION": "Idaho",
"IP_CITY": "Boise",
"IP_ORG": "UNKNOWN",
"OMNISCORE": "54",
"PREVIOUSLY_WHITELISTED": "N",
"THREE_DS_MERCHANT_RESPONSE": "Challenge",
"WARNING_COUNT": "0"
}
RIS Response JSON (with rules triggered)
{
"VERS": "0700",
"MODE": "Q",
"TRAN": "76JG032JT7CD",
"MERC": "888889",
"SESS": "f2d209d0d4cf4c37b0481ff3adcbde00",
"ORDR": "ORDR-1567540565",
"AUTO": "A",
"SCOR": "28",
"GEOX": "US",
"BRND": "VISA",
"REGN": "US_ID",
"NETW": "N",
"KAPT": "Y",
"CARDS": "1",
"DEVICES": "1",
"EMAILS": "1",
"VELO": "0",
"VMAX": "0",
"SITE": "DEFAULT",
"DEVICE_LAYERS": "DF651ACF30..99CF09F417.E3D16F2CB7.061826EF2B",
"FINGERPRINT": "290D1C0172364AADAC25D9FD0B13D946",
"TIMEZONE": "360",
"LOCALTIME": "2019-09-03 13:56",
"REGION": "US_ID",
"COUNTRY": "US",
"PROXY": "N",
"JAVASCRIPT": "Y",
"FLASH": "N",
"COOKIES": "Y",
"HTTP_COUNTRY": "US",
"LANGUAGE": "EN",
"MOBILE_DEVICE": "N",
"MOBILE_TYPE": null,
"MOBILE_FORWARDER": "N",
"VOICE_DEVICE": "N",
"PC_REMOTE": "N",
"RULES_TRIGGERED": "3",
"RULE_ID_0": "183762",
"RULE_DESCRIPTION_0": "DECLINE: More than 4 Unique Email Addresses",
"RULE_ID_1": "183764",
"RULE_DESCRIPTION_1": "DECLINE: More than 4 Unique Credit Cards",
"RULE_ID_2": "183774",
"RULE_DESCRIPTION_2": "REVIEW: Distance from Device to Billing > 1000 km and Persona Score > 50",
"COUNTERS_TRIGGERED": "0",
"REASON_CODE": null,
"DDFS": "2019-08-22",
"DSR": "1050x1680",
"UAS": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/76.0.3809.100 Safari/537.36",
"BROWSER": "Chrome 76.0.3809.100",
"OS": "Mac OS X 10.14.6",
"PIP_IPAD": null,
"PIP_LAT": null,
"PIP_LON": null,
"PIP_COUNTRY": null,
"PIP_REGION": null,
"PIP_CITY": null,
"PIP_ORG": null,
"IP_IPAD": "208.75.113.3",
"IP_LAT": "43.6337",
"IP_LON": "-116.2004",
"IP_COUNTRY": "US",
"IP_REGION": "Idaho",
"IP_CITY": "Boise",
"IP_ORG": "UNKNOWN",
"OMNISCORE": "54",
"PREVIOUSLY_WHITELISTED": "N",
"THREE_DS_MERCHANT_RESPONSE": "Challenge",
"WARNING_COUNT": "0"
}Methods and functions table
Kount recommends the following Java methods/functions used in the RIS response.
|
Attribute |
Description |
|
3D_SECURE_MERCHANT_RESPONSE |
The 3D Secure recommendation based on policies defined within Kount. |
|
AUTO |
Displayed as STAT in the Agent Web Console. The auto-decision response codes are Approve (A), Decline (D), Review (R), Pending (P), and Escalate (E). |
|
BROWSER |
The web browser. |
|
BRND |
Brand of credit card used when payment type is credit card. |
|
CARDS |
Total number of credit cards associated to persona as seen by Kount. |
|
COOKIES |
A flag to indicate if the device placing order has cookies enabled or not. |
|
COUNTERS_TRIGGERED |
Number of unique counter names triggered during rules evaluation. |
|
COUNTER_NAME_X |
Name of the counter that is triggered. |
|
COUNTER_VALUE_X |
The sum of the number of times a counter was triggered. |
|
COUNTRY |
The two-character ISO country code associated with the physical device. |
|
DDFS |
Date of the device first seen. |
|
DEVICES |
The total number of unique devices associated to persona as seen by Kount. |
|
DEVICE_LAYERS |
Five device layers representing the operating system, browser, JavaScript settings, cookie setting, and flash settings. Device layers are used to create the device fingerprint. |
|
DSR |
The device screen resolution. |
|
EMAILS |
The total number of unique email addresses associated to persona as seen by Kount. |
|
ERROR |
A required data point is misconfigured which prevented the risk analysis. |
|
ERROR_COUNT |
Number of errors the customer's RIS POST created. |
|
ERROR_N |
The error code displayed in RIS response. |
|
FINGERPRINT |
The unique fingerprint of the device placing the order. |
|
FLASH |
A flag to indicate if the device placing order has flash enabled or not. |
|
GEOX |
The Persona related country with highest probability of fraud. |
|
HTTP_COUNTRY |
The home country the device owner has set in the device’s Control Panel. |
|
IP_IPAD |
IP address of proxy: IP_COUNTRY - Country of proxy IP address (2, US), IP_LAT - Latitude of proxy IP address (Number, -90.1922), IP_LON - Longitude of proxy IP address (Number, 38.6312), IP_CITY - City of proxy IP address (255, Houston), IP_REGION - State/Region of proxy IP address (255 character limit), IP_ORG - Owner of IP address or address block (64, Organization Name) |
|
JAVASCRIPT |
A flag to indicate if the device placing order has JavaScript enabled or not. |
|
KAPT |
Whether or not device data was collected by the Device Data Collector process. |
|
KYCF |
Whether or not the system knows your customer flag. |
|
LANGUAGE |
The language the device owner has set in the device’s Control Panel. |
|
LOCALTIME |
The local time of the device that the owner has set in the device’s Control Panel. |
|
MERC |
Merchant ID assigned to the merchant by Kount. |
|
MOBILE_DEVICE |
Whether or not the device placing the order is a mobile device (iPhone, Android, Blackberry, iPad). |
|
MOBILE_FORWARDER |
Determines if the mobile device is using a forwarder to process the carrier’s service. |
|
MOBILE_TYPE |
The type/brand of the mobile device. Ex: iPhone, Android, iPad |
|
MODE |
This attribute specifies the RIS mode. Q: RIS call that does not originate from a call center environment. P: RIS call that originates from a call center environment or kiosk. U: Update call to Kount, does not cause a reevaluation of the transaction but will update what is displayed in the Agent Web Console (AWC). This update call does not count towards the number of RIS transactions purchased. Only certain fields can be updated with MODE=U calls. The PTYP field can only be updated if the initial post to Kount was PTYP=NONE. X: Call made after an initial MODE=Q or P request and/or any MODE=U updates have been made. Updates to certain fields can be made and the transaction will be re-evaluated and return an updated RIS response to the merchant. |
|
NETW |
Riskiest network type associated with persona within the last 14 days: Anonymous (A), High School (H), Library (L), Normal (N), Open Proxy (O), Prison (P), Satellite (S) |
|
OMNISCORE |
The Kount Omniscore. A higher score value indicates a safer event/transaction. |
|
ORDR |
The customer's order number. |
|
OS |
The operating system. |
|
PC_REMOTE |
Indicates if the device is enabled to use PC remote software. |
|
PIP_IPAD |
The pierced IP address: PIP_COUNTRY - Country of pierced IP address (2, US), PIP_LAT - Latitude of pierced IP address (Number, -90.1922), PIP_LON - Longitude of pierced IP address (Number, 38.6312), PIP_CITY - City of pierced IP address (255, Houston), PIP_REGION - State/Region of pierced IP address (255 character limit), PIP_ORG - Owner of pierced IP address or address block (64, Organization Name) |
|
PREVIOUSLY_WHITELISTED |
Related to a 3DS workflow, this will identify if consumer has been whitelisted. |
|
PROXY |
Indicates if a proxy server is detected with this order. |
|
REASON_CODE |
The Custom Reason Code associated with Rule Action. |
|
REGN |
Region associated to device location. |
|
REGION |
The region associated to the GEOX location. |
|
RULE_DESCRIPTION_X |
The rule descriptions associated with RULE_ID_X. |
|
RULE_ID_X |
The rule ID associated with the merchant-created rules. |
|
RULES_TRIGGERED |
The number of rules triggered by the RIS POST. |
|
SCOR |
The Kount Persona score. |
|
SESS |
The unique session ID. |
|
SITE |
Website identifier of where the order originated. |
|
TIMEZONE |
The timezone of the device that the owner has set in the device’s Control Panel. The value listed represents the number of minutes from Greenwich Meantime. Divide by 60 to get number of hours. |
|
TRAN |
The Kount transaction ID number. |
|
UAS |
The user agent string. |
|
VELLO |
The quantity of orders seen from the Persona within last 14 days. AUTH field must be equal to A. |
|
VERS |
Specifies the version of Kount built into the SDK. Must be supplied by the merchant if not using the SDK. |
|
VMAX |
The quantity of orders from the Persona within the most active six hour window in last 14 days. AUTH field must be equal to A. |
|
VOICE_DEVICE |
Indicates if the device is voice activated (related to mobile devices). |
|
WARNING_COUNT |
Number of warnings the merchant RIS POST created. |
|
WARNING_N |
The warning code displayed in RIS response. |