Kount allows you to grow your business and protect against sophisticated digital fraud by using Kount’s next-generation AI, combining machine learning with 12 years of experience analyzing billions of transactions across 180+ countries and multiple payment networks all from the convenience of the Miva admin.
With Kount, each order is given an “Approve” or “Decline” from Kount in real-time giving you the tools to decide which orders to ship and which orders to decline.
The Kount module can be downloaded from the Miva App Store here.
Upload the module under “Modules” then assign it to your store under Logging Settings
Kount requires an item to be created and assigned to the following two pages:
Note: The test URL is https://tst.kaptcha.com
The following page template changes are required on both OSEL and OPAY to enable to Device Data Collector JS to be output and run:
Merchant ID - This is given to you via your Kount welcome email. Contact your Kount rep to get this value if you do not have it.
Site - This is the Website ID you create in the Kount interface under Fraud Control -> Websites -> Add Website
API Key - This is created in Kount under Admin -> API Keys -> Create API Key
Give the Key a name and check both RIS and API
Environment - Sandbox or Production
Pre or Post Authorization - This setting determines when the order data is sent to Kount. Pre authorization sends the order data before the payment has been sent to the gateway for authorization. Things like the card number, AVS and CVV are not sent to kount. Post Authorization sends the order data including any available payment data to Kount
KHASH - This value is required if you are using Post Authorization as it's used to encrypt the card data (if available). Contact your Kount rep to get this value.
Notification Email - Leave blank if you don’t want any notification email. If populated, you will receive a simple text email for each order approved by Kount.
Automatically Cancel Declined Orders - When set to yes, if Kount sends back a decline status for an order, the order will get updated to a cancelled status in Miva.
Note: This process does not automatically refund the order. Any refunds or voids will need to be processed manually in the Miva admin.
If you are using pre auth with this setting set to true and Kount sends back a Decline as the status, the customer's payment will not be set to the gateway for authorization. Instead the customer will see a generic "Your Order has been declined" error message.
Kount ENS URL - This is a URL specific to your store which gets created once the module is installed. You'll use this URL when you are creating the website in Kount.
The URL will have the following format: https://www.domain.com/mm5/json.mvc?Store_Code=STORE_CODE&Function=Module&Module_Code=kount&Session_Type=runtime&Module_Function=JSON_WebHook
Kount ENS stands for Event Notification System. When order data is sent to Kount to get a score, most orders get an immediate response such as Approve or Decline. In some cases additional time is needed to review the orders. In these cases a notification will be sent to Miva to update the Kount status in Miva using the ENS URL.
Clear Log Table The Kount module has a database table which is used to track requests and responses sent to Kount. It is recommended that this table be cleaned up periodically to prevent it from growing too large.
Kount has 4 possible status values it will return for each order:
A = Approved
R = Review
E = Escalate - https://support.kount.com/s/article/Escalate-Order-Status
D = Declined
The Kount status is viewable in the Miva admin in 3 locations:
Both orders placed via the Miva admin such as a phone order and orders created by Miva's subscripton system will not be sent to Kount and no Kount status will exist.
The response data Kount sends Miva for each order is available to use in an Order Workflow. The correct syntax would look like this:
Miva Order Workflows allow you to automatically add or remove orders for specific queues in Miva based on the results of the Kount status.
Both Kount Status and Kount Transaction ID are available via the Miva JSON API. To access them you need to pass the following in your OrderList_Load_Query API call for the ondemand columns.
Note: You can also get the Kount data in your response if you are requesting all custom field data: customfield_values:*
Note: the above response is a snippet of a larger response returned from OrderList_Load_Query
The module automatically logs requests and responses from Kount into a table s0x_kount_log. This data can be used to help troubleshoot problems. It can only be viewed directly in the database.