How to Integrate the Kount Command Shopify App

Installing the Kount Command app on your Shopify Store website involves a few simple 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

Benefits of Kount Command

• Reduced Chargebacks: Kount owns the core technology behind reduced chargebacks, resulting in accurate decisions within milliseconds. Suspect orders are stopped before a chargeback occurs.
• Automation: Kount can automatically accept or decline orders in 250 to 300 milliseconds. Auto Agent is a secondary review process that allows for compete automation on demand.
• Simple API Integration: The Kount API integration allows merchant development teams to spend more time focusing on complex issues.

Install Kount Command for Shopify Stores

Shopify Kount Test App

Before integrating in the production environment, you must set up the Kount Shopify test app to ensure integration works as expected without errors.

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. 

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.
   
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 Shopify Test App

1. In a new browser window, click Get on the Kount Shopify Test app page to display:
   
   
   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.
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.
   
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.
   
6. Click Submit form. A successful installation prompt displays.
   

Step 3: Enable the ENS Callback URL in the Kount Shopify Test 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:
   
   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.
   

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.
   
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:
   
   
   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.
   
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.
   
6. Click Submit form. A successful installation prompt displays.
   

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:
   
   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.
   

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.
   
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 .
   
   
   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.
   
6. Click Submit form. A successful installation prompt displays.
   

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

View full analysis link

Installed Apps

App Configurations

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

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.

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.

Submit Default Automatic Approval: When the Kount app receives an order, the Shopify API is notified to set a note that this order is approved: [Kount]: Kount has set this order to be under automatic approval. The order then processes and updates the order appropriately upon successful completion. The goal here is to make sure there is a default approve assessment, even if the processing of the order fails. The default setting is enabled.

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

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.

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.

Disable: Select this checkbox to temporarily disable sending transactions to Kount for a Risk Assessment.

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.

• Write Rules Using UDFs
• Manage UDFs

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