Request Types and Parameters

Here we discuss the request types supported by the Kount RIS Java SDK and mandatory/optional parameters.

Request types

There are two major Request types: Inquiry and Update. Their handling by the RIS service can be configured by setting the MODE parameter to the correct value.

Inquiry type should be used for initial registration of the purchase in the Kount system. It has four available values for the MODE parameter.

Inquiry MODE	SDK Constant	Description
Q	InquiryType.ModeQ	Default inquiry mode, internet order type
P	InquiryType.ModeP	Used to analyze a phone-received order
W	InquiryType.ModeW	Kount Central full inquiry with returned thresholds
J	InquiryType.ModeJ	Kount Central fast inquiry with just thresholds

Update type should be used whenever there are changes to a given order and the merchant wants them reflected into the Kount system. Update has two available values for the MODE parameter.

Update MODE	SDK Constant	Description
U	UpdateType.ModeU	Default update mode, only sends the update event
X	UpdateType.ModeX	Sends the update event and RIS service returns a status response

Mandatory parameters

Parameter name	Setter	Q	P	W	J	U	X
MODE	SetMode	✅	✅	✅	✅	✅	✅
VERS	SetVersion	✅	✅	✅	✅	✅	✅
MERC	SetMerchantId	✅	✅	✅	✅	✅	✅
SITE	SetWebsite	✅	✅	✅
SESS	SetSessionId	✅	✅	✅		✅	✅
CURR	SetCurrency	✅	✅	✅	✅
TOTL	SetTotl	✅	✅	✅	✅
CUSTOMER_ID	SetKountCentralCustomerId			✅	✅
PTYP		✅	✅	✅	✅
IPAD	SetIpAddress	✅	✅	✅	✅
MACK	SetMack	✅	✅	✅		✅	✅
TRAN	SetTransactionId					✅	✅
PROD_TYPE	⚠️	✅	✅	✅
PROD_ITEM	⚠️	✅	✅	✅
PROD_QUANT	⚠️	✅	✅	✅
PROD_PRICE	⚠️	✅	✅	✅
ANID	SetAnid		✅

⚠️ Parameters marked with this warning sign are the shopping cart parameters. They are bulk-set by the Inquiry.SetCart(ArrayList<CartItem> cart) method. If shopping cart contains more than one entry, values for each parameter are transformed to single concatenated strings and then set to the corresponding parameter.

Optional parameters

The Kount RIS Dotnet SDK provides a huge number of optional request parameters to increase precision when making a decision about a given purchase / order.

Only the most interesting parameters will be mentioned here. A comprehensive listing of all SDK-set parameters can be found on the .netDoc pages for Request, Inquiry, and Update classes.

• AUTH: Authorization Status returned to merchant from processor. Acceptable values for the AUTH field are A for Authorized or D for Decline. In orders where AUTH = A will aggregate towards order velocity of the persona while orders where AUTH = D will decrement the velocity of the persona.
• AVST: Address Verification System Street verification response returned to merchant from processor. Acceptable values are M for match, N for no-match, or X for unsupported or unavailable.
• AVSZ: Address Verification System Zip Code verification response returned to merchant from processor. Acceptable values are M for match, N for no match, or X for unsupported or unavailable.
• CVVR: Card Verification Value response returned to merchant from processor. Acceptable values are M for match, N for no-match, or X unsupported or unavailable.
• LAST4: Last 4 numbers of Credit Card Value.

User-defined fields

Kount provides a way for merchants to include additional information related to their business that may not be a standard field in Kount by creating user defined fields. UDFs are created in the Agent Web Console by browsing to the Fraud Control tab and clicking on User Defined Fields. Once you have defined the UDF in the AWC you will be able to pass this data into Kount via an array called UDF as key-value pairs where the label is the key and the data passed in is the value. The maximum number of UDFs that can be created is 500, and response time for evaluating transactions will degrade as more UDFs are added. There are four data types available for user defined fields.

⚠️ UDF labels can be up to 28 characters in length. UDF labels cannot begin with a number.

Attribute	Size	Description	Example
UDF[NUMERIC_LABEL] = value	1-255	Numbers, negative signs, and decimal points	UDF[FREQUENCY] = 107.9
UDF[ALPHA_NUMERIC_LABEL = value	1-255	Letters, numbers, or both	UDF[COUPON] = BUY11
UDF[DATE_LABEL] = value	1-20	Formatted as YYYY-MM-DD or YYYY-MM-DD HH:MM:SS	UDF[FIRST_CONTACT] = 2017-04-25 17:12:30
UDF[AMOUNT_LABEL] = value	1-255	Integers only, no decimal points, signs or symbols	UDF[BALANCE] = 1100

---