Request types and Parameters

Request types and Parameters

Here we discuss the request types supported by the Kount RIS Python 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	INQUIRYMODE.DEFAULT	Default inquiry mode, internet order type
P	INQUIRYMODE.PHONE	Used to analyze a phone-received order
W	INQUIRYMODE.WITHTHRES HOLDS	Kount Central full inquiry with returned thresholds
J	INQUIRYMODE.JUSTTHRES HOLDS	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	SDK Constant	Description
U	UPDATEMODE.NO_RE SPONSE	Default update mode, only sends the update event
X	UPDATEMODE.WITH_ RESPONSE	Sends the update event and RIS service returns a status response

Mandatory parameters

Parameter name	Setter	Q	P	W	J	U	X
MODE	set_mode	Y	Y	Y	Y	Y	Y
VERS	version_set	Y	Y	Y	Y	Y	Y
MERC	merchant_set	Y	Y	Y	Y	Y	Y
SITE	website	Y	Y	Y
SESS	session_set	Y	Y	Y		Y	Y
CURR	currency_set	Y	Y	Y	Y
TOTL	total_set	Y	Y	Y	Y
MACK	merchant_acknowledgment_set	Y	Y	Y
CUSTOMER_ID	kount_central_customer_id			Y	Y
PTYP		Y	Y	Y	Y
IPAD	ip_address | Y		Y	Y	Y
TRAN	set_transaction_id					Y	Y
PROD_TYPE	warning:	Y	Y	Y
PROD_ITEM	warning:	Y	Y	Y
PROD_QUANT	warning:	Y	Y	Y
PROD_PRICE	warning:	Y	Y	Y
ANID	warning:		Y

warning:	Parameters marked with this warning sign are the shopping cart parameters. They are bulk-set by the Inquiry.set_cart(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 Python 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 python-doc 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.

Attribute	Size	Description	Example
UDF[NUMERIC_LABE L] = value	1-255	Numbers, negative signs, and decimal points	UDF[FREQUENCY] = 107.9
UDF[ALPHA_NUMERI C_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

Table: warning: UDF labels can be up to 28 characters in length. UDF labels cannot begin with a number.