Risk Inquiry Service Response

July 13, 2023 22:43

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 (with no 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": 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,

    "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,

    "THREE_DS_MERCHANT_RESPONSE": "Challenge"

    "WARNING_COUNT": 0

    }

Kount recommends at the minimum the following methods/functions used in the RIS response.

RIS response Java method examples

MERC	getMerchantId()
MODE	getMode()
TRAN	getTransactionId()
ORDR	getOrderNumber()
AUTO	getAuto()
SCOR	getScore()
KAPT	getKaptcha()
SITE	getSite()
WARNING	hasWarnings()
	getWarningCount()
	getWarnings()

ERROR	hasErrors()
	getErrorCount()
	getErrors()
	getErrorCodes()

Was this article helpful?

0 out of 1 found this helpful