Quick Links

How to Install and Set Up the Kount Command Shopify App

Installing the Kount Command app on your Shopify Store website involves a few steps. Prior to using the Kount Agent Web Console (AWC), customers are required to sign a contract with Kount LLC, and receive a product demonstration delivered remotely by a dedicated account team. If you are not already a Kount Command customer, contact your Kount representative to be paired with an account executive and schedule a demonstration.

Get the App

After a demonstration, work with a Customer Success Manager to walk through installation and onboarding. Your Client Success Manager provides the following information, necessary to install and begin using Kount.

  • Your Merchant ID
  • Login credentials for the Agent Web Console
NOTE: Although installation without a Merchant ID is possible, Kount Command does not work until the ID is entered.

Install Kount Command for Shopify Stores

Before integrating in the production environment, you must set up the Kount Shopify Test app to ensure integration works as expected without errors. The installation steps below are the same for both the Test and Production Shopify app.

Step 1: Create an API Key in Kount

An Application Programming Interface (API) key is a unique identifier for each customer and is required to connect to the Kount Test App. 

API keys are required to authenticate to Kount when using RIS, making an API call, or for various system integrations. Each customer is assigned a 32-character hash key that acts as a password for their API calls. API keys are unique per customer and environment.

NOTE: This key must be kept private. If the customer – or Kount – believes the API key has been compromised, a new key must be issued.

Steps for creating an API key

  1. Log into the Agent Web Console.
  2. Click Admin, and then select API Keys.
  3. Click Create API Key.
  4. Enter a Key Name, select your desired Key Permissions (typically RIS and API), and then click Create API Key. If the key is successfully created, a confirmation appears.
  5. The new key displays on the API Key Management screen.
  6. Copy and paste the API key into other applications, as necessary.

Step 2: Confirm the one-time purchase for the Shopify App

Before the Shopify app purchase has been approved, you will receive a warning prompting you to contact Kount to set up an account – using your Merchant ID and API Key – and then purchase the app.

 

Clicking Purchase redirects you to a purchase confirmation page.

 

Once the purchase has been confirmed, the app configuration page appears. Continue to Step 3 to  configure and begin using the app. Contact your Customer Success Manager for additional information about the one-time app purchase.

Step 3: Install the Kount Shopify Test/Production App

After completing Step 2, the Configuration page displays.

mceclip0.png

NOTE: The ENS Callback URL is auto-generated with every installation to reflect the store for which the installation is occurring. The auto-generated URL contains the respective shop name for the test environment.
  1. In the Merchant ID text box, enter the six-digit Merchant ID provided to you by Kount.
  2. Copy the API Key generated in Step 1 and paste it in the API Key textbox.
  3. Copy the ENS Callback URL exactly as it displays to be used in the next step.
  4. Click Save. A successful installation prompt displays.

Step 4: Enable the ENS Callback URL in the Kount Shopify app

 

  1. Refresh your AWC browser window.
  2. Click the Fraud Control menu and select Websites from the drop-down menu. The default site displays:
    mceclip4.png
    The Website Enabled and ENS Enabled columns display No, and the Merchant ENS URL column is blank.
  3. On the right side of the website row, click the gear icon, and then click Edit to display the Edit Row pop-up message.
  4. Select the Yes radio buttons for Website Enabled and ENS Enabled, and then paste the ENS Callback URL from the previous step into the Merchant ENS URL text box.
  5. Click Update Website.
    mceclip5.png
NOTE: The following steps must be completed in sequential order to successfully setup Kount Command.

For Single Shopify Stores

Step 1: Create an API Key in Kount

An Application Programming Interface (API) key is a unique identifier for each customer and is required to connect to Kount Command. If you are going to set up Multiple Shopify Stores, use the same API key for all subsequent sites.

  1. Log in to the AWC using your Kount credentials.
  2. Click the ADMIN tab, and then select API Keys from the drop-down menu.
  3. Click Create API Key in the lower-right corner of the API Key Management screen.
  4. In the pop-up window, provide a Key Name, select the API and RIS checkboxes, and then click Create API Key. Your new API key displays on the API Key Management screen.
    mceclip1.png
  5. Save the API key to a document or leave the browser window open to the API page to use in the next step.

Step 2: Install the Kount Command app for your Shopify store

  1. In a new browser window, click Get on the Kount Command app page to display:
    mceclip0.png
    NOTE: The ENS Callback URL is auto-generated with every installation to reflect the store for which the installation is occurring. The auto-generated URL contains the respective shop name in place of kount-test in the example.
  2. In the Merchant ID text box, enter the six-digit Merchant ID provided to you by Kount.
  3. Copy the API Key from the API Key Management screen of the AWC.
    mceclip1.png
  4. In the API Key text box, paste the API key from the API Key Management screen.
  5. Copy the ENS Callback URL exactly as it displays to be used in the next step.
    mceclip2.png
  6. Click Submit form. A successful installation prompt displays.
    mceclip3.png

Step 3: Enable the ENS Callback URL in Kount Command

  1. Refresh your AWC browser window.
  2. Click the Fraud Control menu and select Websites from the drop-down menu. The default site displays:
    mceclip4.png
    The Website Enabled and ENS Enabled columns display No, and the Merchant ENS URL column is blank.
  3. On the right side of the website row, click the gear icon, and then click Edit to display the Edit Row pop-up message.
  4. Select the Yes radio buttons for Website Enabled and ENS Enabled, and then paste the ENS Callback URL from the previous step into the Merchant ENS URL text box.
  5. Click Update Website.
    mceclip5.png

For Multiple Shopify Stores

Step 1: Locate your API Key in Kount

Use the same API key you created when installing Kount on your default site for all subsequent sites.

  1. Log in to the AWC using your Kount credentials.
  2. Click the ADMIN tab, and then select API Keys from the drop-down menu.
  3. Copy the existing API Key from the API Key Management screen.
    mceclip6.png
  4. Leave the browser window open to the API page to use in the next step.

Step 2: Install the Kount Command app for your Shopify shop store

  1. In a new browser window on the Kount Command app page, click Get .
    mceclip7.png
    NOTE: The ENS Callback URL is auto generated with every installation to reflect the store for which the installation is occurring. The auto-generated URL contains the respective shop name in place of kount-test in the example.
  2. Enter the six-digit Merchant ID provided to you by Kount in the Merchant ID text box.
  3. In the API Key text box, paste the API key from the API Key Management screen.
  4. Enter a name for the site in the Website text box. The name should correspond to the site's unique URL.
  5. Copy the ENS Callback URL exactly as it displays. You must use it in the following step.
    NOTE: The auto-generated ENS Callback URL reflects the respective site name in place of kount-test in the example.
    mceclip8.png
  6. Click Submit form. A successful installation prompt displays.
    mceclip9.png

Step 3: Create the website in Kount Command

Any website created after the default must be manually added to the AWC, as follows:

  1. Click the Fraud Control menu, and then select Websites from the drop-down menu.
  2. Click Add Website.
  3. Enter the same website name you entered in Step 2 into the Website textbox.
  4. Enter a description (optional).
  5. Select Yes for ENS Enabled.
  6. Paste the ENS Callback URL from Step 2 in the Merchant ENS URL text box.
  7. Click Add Website.

Sending Transactions to Kount

All transactions go through Kount once your website is communicating with Kount Command. Kount Command runs its fraud detection technology in the background as your customers interact with your shop. Kount displays in several places within your shop's Shopify user interface.

Order Details

mceclip10.png
mceclip11.png

View full analysis link

mceclip12.png

Installed Apps

mceclip13.png

App Configurations

Under the Config tab, you can change your Shopify App configuration. See the list below for information about each configuration.

mceclip1.png

Single Basic Indicator (enabled by default): This sends a single fraud indicator to an order in Shopify. This helps optimize API usage in Shopify. If disabled your shop is more likely to exceed the API limits set by Shopify. Refer to Shopify API Rate Limits for API rate specifics.

Auto-Capture: Select this checkbox to enable the auto-capture functionality of this app. If this is enabled and Kount approves a transaction, it calls the Shopify API to capture payment. This feature only works when gateway settings are set to Authorize Only.

NOTE: Kount recommends that the gateway not be configured to auto-capture to avoid causing fulfillment issues with the OMS.

Auto-Void: Select this checkbox to enable the auto-void functionality of this app. If enabled and Kount declines a transaction, it calls the Shopify API to void the authorization.

Auto-Cancel (enabled by default): Transactions declined in Kount contact the Shopify API to cancel the order. If disabled, you must manually cancel it in Shopify.

Auto-Refund: Select this checkbox to refund a purchase and add items back into inventory when Kount responds with D (Decline), either initially or through a manual review.

Disable All: Select this checkbox to temporarily disable sending transactions to Kount for a Risk Assessment.
Disable Phone Orders: Orders placed on behalf of a shopper is not sent to Kount for a Risk Assessment.
Send Refunds: Information is be sent to Kount for orders that are refunded by the shopper.
Submit Recurring Transactions: If the merchant is using an app for recurring transactions and the checkbox is selected, it submits all the transactions, including the recurring one. If the checkbox is not selected, only the first transaction is submitted, not the recurring transactions. The default for this is enabled. Currently Recharge is the only one supported here, but as we discover more, we implement the same functionality.

Additional Resources

In the Kount Command Agent Web Console (AWC), User Defined Fields appear on the Transaction Details page and in the Rules Engine. These fields are specific to your business needs and can be created for you by your Client Success Manager during onboarding.

mceclip14.png

Contact support at support@kount.com if you have any questions or need assistance with rules management.

Was this article helpful?
0 out of 0 found this helpful