How to Install and Configure the Kount App in the BigCommerce Marketplace

June 12, 2024 15:51

Provide fraud protection to your storefront by installing the Kount Command add-on in the BigCommerce marketplace. Kount Command is the leading AI-driven fraud protection solution for your business. To successfully set up the Kount app, you must have your Kount Agent Web Console (AWC) login, and an existing BigCommerce account.

Step 1: Create a new API key

You must create a new API key before configuring the Kount app. Go to the Kount Portal and log into the Kount AWC.

Note

If after you log in you are directed to the dashboard, select Admin from the navigation tabs, and then select API Keys.
From the bottom of the page, select Create API Key.
Next to Key Name, enter BIGC, and then under Key Permissions, select the RIS and API checkboxes.
Select Create API Key. A message displays confirming your key was created successfully.

Step 2: Add a BigCommerce website in the AWC

Go to the Kount Portal.
From the bottom of the page, click Add Website.
Under Website, enter BIGC, and then under description, enter The BigCommerce Website.
Select Add Website. A message displays confirming the website was added successfully.

Note

If you are using a single Kount merchant account to point to more than one BigCommerce store, reach out to your technical contact at Kount to help you configure your installation.

Step 3: Install the Kount app in the BigCommerce marketplace

Test/Sandbox

If Kount provided you with a ZIP file, follow these steps to set up the plugin for testing in a sandbox environment.

Download the Kount Test ZIP file.
Click Learn more, and then select Install.
Click the checkbox to confirm the app can access the listed data, and then select Confirm.
Enter the following configuration information.
1. Merchant ID: The Kount provided six-digit ID.
2. API Key: The API Key created in the API Key Management screen within the AWC.
3. Website: The Website setup in the AWC or use 'BIGC'.
4. ENS Callback URL: URL configured in the AWC for receiving Event Notification System messages. This is a read-only field and is used as the value for the ENS API URL configured in the Kount AWC.
5. Auto-Capture: When Kount approves a transaction, call the BigCommerce API to capture payment. If your gateway supports an option to select Auth Only or Auth/Capture, and you choose to use Auth/Capture, you can enable this setting to allow Kount's decision to be used to trigger the capture for the order.
6. Auto-Void: When Kount declines a transaction, void the payment in BigCommerce or your payment gateway.
7. Auto-Cancel: When Kount declines a transaction, cancel the transaction in BigCommerce or your payment gateway.
8. Disable: Disable sending transaction to Kount for a Risk Assessment.
Select Save, and then click Dismiss to return to the configuration.

Production

If you are done testing and ready to install the plugin in your production environment, follow these steps:

In the BigCommerce Marketplace, search for and select the Kount Command app.
Select Learn more, and then Install.
Select the checkbox to confirm the app can access the listed data, and then select Confirm.
Enter the following configuration information.
1. Merchant ID: The Kount provided six-digit ID.
2. API Key: The API Key created in the API Key Management screen within the AWC.
3. Website: The Website setup in the AWC or use 'BIGC'.
4. ENS Callback URL: URL configured in the AWC for receiving Event Notification System messages. This is a read-only field and is used as the value for the ENS API URL configured in the Kount AWC.
5. Auto-Capture: When Kount approves a transaction, call the BigCommerce API to capture payment. If your gateway supports an option to select Auth Only or Auth/Capture, and you choose to use Auth/Capture, you can enable this setting to allow the Kount decision to be used to trigger the capture for the order.
6. Auto-Void: When Kount declines a transaction, void the payment in BigCommerce or your payment gateway.
7. Auto-Cancel: When Kount declines a transaction, cancel the transaction in BigCommerce or your payment gateway.
8. Disable: Disable sending transaction to Kount for a Risk Assessment.
Select Save, and then select Dismiss to return to the configuration.

Step 4: Update the AWC

Return to Fraud Control.
Next to the BIGC website you created earlier, click the Gear icon, and then click Edit.
Under ENS enabled, select Yes.
Under Merchant ENS URL, enter the URL with the ENS Callback URL page provided during the BigCommerce installation.

Note

Work with your Customer Success Manager to optimize your business policies to take advantage of the information provided via the BigCommerce Kount Command App.

Submitting Chargebacks with the Kount API Endpoint

You can submit chargebacks to Kount using Kount's Endpoint API.

Set up your network configuration to receive the webhook (POST):

Intercept the /store/order/statusUpdated webhook and check to see if new_status_id = 13 (disputed) or new_status_id = 4 (refund).

Retrieve the data using the BigCommerce Get Metafields API. Look up the Kount transaction using id from the POST (JSON payload), and then find the correct metafield for the Transaction ID to make a call to the Refund/Chargeback Kount API.

sidebar. Example return from the Get Metafields API

Refer to this example of a return from the Get Metafields API.

{
    "data": [
        {
            "id": 4896,
            "key": "RISTransactionId",
            "value": "KKZY0BYHKB81",
            "namespace": "kount",
            "permission_set": "app_only",
            "resource_type": "order",
            "resource_id": 5513,
            "description": "",
            "date_created": "2022-03-09T18:56:01+00:00",
            "date_modified": "2022-03-09T18:56:01+00:00"
        },
        {
            "id": 4897,
            "key": "LastStatus",
            "value": "11",
            "namespace": "kount",
            "permission_set": "app_only",
            "resource_type": "order",
            "resource_id": 5513,
            "description": "",
            "date_created": "2022-03-09T18:56:01+00:00",
            "date_modified": "2022-03-09T18:56:01+00:00"
        }
    ],
    "meta": {
        "pagination": {
            "total": 2,
            "count": 2,
            "per_page": 50,
            "current_page": 1,
            "total_pages": 1,
            "links": {
                "current": "?page=1&limit=50"
            }
        }
    }
}

Update the Kount transaction with the Kount Chargeback API.

Was this article helpful?

1 out of 1 found this helpful

How to Install and Configure the Kount App in the BigCommerce Marketplace

Step 1: Create a new API key

Note

Step 2: Add a BigCommerce website in the AWC

Note

Step 3: Install the Kount app in the BigCommerce marketplace

Test/Sandbox

Production

Step 4: Update the AWC

Note

Submitting Chargebacks with the Kount API Endpoint