Skip to main content


Utilizing external risk checks such as Kount can significantly enhance your transaction security. This guide provides detailed information on the specific parameters and scripts required to enable Kount risk checks in your transactions.

Transaction extra data

For Kount external risk checks, you need to include specific items and parameters in the extraData of your transaction. The parameters Site and at least one item are mandatory. If you are not using payment.js, the parameter SessionId becomes necessary as well. Additionally, the customer provided in the transaction request must have a valid IPv4 address (customer.ipAddress).

Here's a breakdown of the required and optional parameters:

KOUNT_SITEstringYour Kount Site configured in Kount
KOUNT_SESSION_IDstringUnique kountSessionId
KOUNT_UDF[YOUR_USER_DEFINED_FIELD_1]optional stringAnything
KOUNT_UDF[YOUR_USER_DEFINED_FIELD_2]optional stringAnything
KOUNT_TOTAL_AMOUNToptional stringIf amount to evaluate differs from transaction amount
KOUNT_CURRENCYoptional stringIf currency to evaluate differs from transaction currency

For each item, you need to provide specific details beginning with an index of 0. Alternatively, you can use the items[].extraData field on the transaction request to add the necessary data:

KOUNT_PROD_TYPE[0]stringItem type
KOUNT_PROD_ITEM[0]stringItem name
KOUNT_PROD_DESC[0]stringItem description
KOUNT_PROD_QUANT[0]numberItem quantity
KOUNT_PROD_PRICE[0]stringItem price

If using the transaction item extra data:

KOUNT_PROD_TYPEstringItem type
KOUNT_PROD_ITEMstringItem name
KOUNT_PROD_DESCstringItem description
KOUNT_PROD_QUANTnumberItem quantity
KOUNT_PROD_PRICEstringItem price

Initializing the risk script

Similar to other external risk checks, you need to initialize risk scripts to enable Kount risk checks. Depending on your settings, you might have to manually initialize these scripts.

In cases where the connector or risk profile associated with your Public Integration Key isn't set to automatically initialize Kount, you need to manually initiate it with payment.js. If Init Scripts Automatically is enabled, no further javascript steps are required for embedding Kount.

const payment = new PaymentJs("1.2");

payment.init("public-integration-key", "number_div", "cvv_div", (payment) => {
// ...
try {
payment.initRiskScript({ type: "kount" });
} catch (exception) {
//this might happen on an invalid configuration at risk profile or connector level

Remember to accurately include all necessary information for successful risk checks with Kount. If you encounter issues, review your connector configuration or the extra data you're providing.