RIS Error Codes

An important use of the RIS response is the ability to verify if the decision-making process was successful and view any warnings or errors that were made during the RIS post from the merchant. All warnings will be displayed in the response and if errors do occur the RIS response will be returned with a MODE = E.

Here’s a list of all used RIS warning and error codes.

Response Code Warning/Error Label Response Code Description
201 MISSING_VERS Missing version of Kount, this is built into SDK but must be supplied by merchant if not using the SDK
202 MISSING_MODE The mode type for post is missing. Refer to the RIS Modes page for more information.
203 MISSING_MERC The six digit Merchant ID was not sent
204 MISSING_SESS The unique session ID was not sent
205 MISSING_TRAN Transaction ID number
211 MISSING_CURR The currency was missing in the RIS submission
212 MISSING_TOTL The total amount was missing
221 MISSING_EMAL The email address was missing
222 MISSING_ANID For MODE = P RIS inquiries the caller ID is missing
223 MISSING_SITE The website identifier that was created in the Agent Web Console (DEFAULT is the default website ID) is missing
231 MISSING_PTYP The payment type is missing. Refer to the RIS Payment Types
232 MISSING_CARD The credit card information is missing
233 MISSING_MICR Missing Magnetic Ink Character Recognition string
234 MISSING_PYPL The PayPal Payer ID is missing
235 MISSING_PTOK The payment token is missing.
241 MISSING_IPAD The IP address is missing
251 MISSING_MACK The merchant acknowledgement is missing
261 MISSING_POST The RIS query submitted to Kount contained no data
271 MISSING_PROD_TYPE The shopping cart data array attribute is missing.
272 MISSING_PROD_ITEM The shopping cart data array attribute is missing.
273 MISSING_PROD_DESC The shopping cart data array attribute is missing.
274 MISSING_PROD_QUANT The shopping cart data array attribute is missing.
275 MISSING_PROD_PRICE The shopping cart data array attribute is missing.
301 BAD_VERS The version of Kount supplied by merchant does not fit the four integer parameter
302 BAD_MODE The mode type is invalid. Refer to the RIS Inquiry Service Modes: inquiry
303 BAD_MERC The six digit Merchant ID is malformed or wrong
304 BAD_SESS The unique session ID is invalid. Refer to the Data Collector
305 BAD_TRAN Transaction ID number is malformed
311 BAD_CURR The currency was wrong in the RIS submission
312 BAD_TOTL The total amount is wrong. TOTL is the whole number amount charged to customer
321 BAD_EMAL The email address does not meet required format or is greater than 64 characters in length
322 BAD_ANID For MODE = P RIS inquiries the caller ID is malformed
323 BAD_SITE The website identifier that was created in the Agent Web Console (DEFAULT is the default w website ID) does not match what was created in the AWC.
324 BAD_FRMT The specified format is wrong. Format options are key value pairs, XML, JSON, YAML
331 BAD_PTYP The payment type is wrong. Refer to the RIS Payment Types
332 BAD_CARD The credit card information is malformed or wrong, test cards do not work in the production environment
333 BAD_MICR Malformed or improper Magnetic Ink Character Recognition string.
334 BAD_PYPL The PayPal Payer ID is malformed or corrupt.
335 BAD_GOOG Malformed or improper Google Checkout Account ID string.
336 BAD_BLML Malformed or improper Bill Me Later account number.
337 BAD_PENC The encryption method specified is wrong.
338 BAD_GDMP The GreenDot payment token is not a valid payment token
339 BAD_HASH When payment type equals CARD, PTYP = CARD and payment encryption type equals KHASH, `PENC = KHASH the value must be 20 characters in length.
340 BAD_MASK Invalid or excessive characters in the PTOK field
341 BAD_IPAD The IP address does not match specifications
342 BAD_GIFT The Gift Card payment token is invalid due to invalid characters, null, or exceeding character length
351 BAD_MACK The merchant acknowledgement must be Y or N
362 BAD_CART There is a discrepancy in the shopping cart key count and the number of items actually being sent in the cart
371 BAD_PROD_TYPE The shopping cart data array attribute is missing.
372 BAD_PROD_ITEM The shopping cart data array attribute is corrupt or missing.
373 BAD_PROD_DESC The shopping cart data array attribute is corrupt or missing.
374 BAD_PROD_QUANT The shopping cart data array attribute is corrupt or missing.
375 BAD_PROD_PRICE The shopping cart data array attribute is corrupt or missing.
399 BAD_OPTN A UDF has been mistyped or does not exist in the Agent Web Console
401 EXTRA_DATA RIS keys submitted by merchant were not part of SDK
404 UNNECESSARY_PTOK When PTYP equals NONE and a PTOK is submitted
413 REQUEST_ENTITY_TOO_ LARGE The RIS Post to Kount exceeded the 4K limit.
501 UNAUTH_REQ Error regarding certificate - Using test certificate in prod
502 UNAUTH_MERC Invalid Merchant ID has been entered
601 SYS_ERR Unspecified system error - Contact Merchant Services
602 SYS_NOPROCESS Kount will not process particular transaction
701 NO_HDR No header found with merchantId = [XXXXX], session_id = [htot2kk5khpamo45f777q455], trans=[122347] This error occurs when a RIS request goes to the database and there is no data available in the reply. The Update post had an invalid transaction ID#. Check all required fields for update post and confirm they are being passed correctly.
  • Missing: When this designation appears, the customer has failed to complete a required field.
  • Bad: When this designation appears, some data was sent but failed to meet specifications. This could also be explained as malformed data or bad code that did not meet specifications, such as AVS = W instead of AVS = M.

RIS SDKs
Event Notification Service