¶ Kount Integration
Integrate RevCent with Kount for fraud prevention and more. Read more about Kount at https://kount.com. If you are interested in integrating your RevCent account with Kount, please contact us.
¶ Overview
RevCent integrates with Kount via a third party integration. After setting up Kount in RevCent, you can utilize the Kount Risk Inquiry Service (RIS). Kount RIS is a service for detecting fraud before submitting a payment request to your processor. All sale payment requests will first be sent to Kount RIS to check for fraud. If Kount returns a score less than or equal to your desired threshold, RevCent will decline the purchase without sending it to your payment processor. If the Kount RIS score is greater than your desired threshold, RevCent will continue the payment with your processor.
¶ How It Works
¶ Before You Start
You will need to contact us before integrating your RevCent account with Kount. We will go over integration, usage details, pricing and more.
¶ Set Up Instructions
Once you have contacted us and have gone over the Kount integration, complete the steps below complete the integration.
¶ Step 1. Create New Third Party Integration
View the third party integrations page by clicking Integrations > Third Party > Integrations in the sidebar and click the Create New Third Party Integration button or go to https://revcent.com/user/new-third-party-integration
- Enter a name. Required.
- Enter a description.
- Click the Create New Third Party Integration button.
- The page will redirect you to the new third party integration page.
- Continue to Step 2.
¶ Step 2. Select Third Party
- Select the status of your new third party integration. If disabled, Kount will not be contacted for fraud requests.
- Select Kount in the Third Party dropdown.
- After selecting Kount in the dropdown, additional form fields will appear on the page.
- Continue to Step 3.
¶ Step 3. Enter Kount API Key
Important: This step is optional and only for those who have an existing Kount enterprise account. If you do not have an enterprise account with Kount, leave this field blank and continue to step 4.
- Enter your Kount API Key.
- Click the Test button to ensure RevCent can successfully connect to your Kount account.
- If the test is successful, click the Save button.
- Continue to Step 4.
¶ Step 4. Create New Webhook
You will need to create a webhook within RevCent specific to this Kount integration. This is so RevCent can receive notifications from Kount.
- Select Create New in the Webhook dropdown.
- Continue to Step 5.
¶ Step 5. Save Changes & Wait
- Click the Save Changes button at the bottom of the page to finish.
- Wait for the page to automatically reload.
- Upon reloading, two additional form fields will appear.
- Continue to Step 6.
¶ Step 6. Enter Kount Merchant ID
Important: This step is optional and only for those who have an existing Kount enterprise account. If you do not have an enterprise account with Kount, leave this field blank and continue to step 7.
- Enter your Kount Merchant ID associated with your Kount enterprise account.
- Continue to Step 7.
¶ Step 7. Set Your Risk Score Threshold
The Risk Score Threshold is extremely important, and will determine whether or not payment requests are sent to your processor.
- Set your Risk Score Threshold. Recommend value is 10. If the Risk Score Threshold you enter is less than or equal to the score returned by Kount, the payment request is immediately returned as fraud and not sent to your processor.
- Continue to Step 8.
¶ Step 8. Save & Finish
- Click the Save Changes button at the bottom of the page to finish.
- Once the page has reloaded you are all set and integrated with Kount.
¶ Step 9. Setup Complete
Congratulations. You have successfully integrated RevCent with Kount. Proceed below to the section on Kount Session ID.
¶ Kount Session ID
In order for Kount RIS to properly detect fraud, a Kount session ID must be provided in order to match a purchase request with the website visitor who is making the purchase. RevCent does the communication with Kount RIS for you, however RevCent needs your website visitors' Kount session ID to successfully process the request.
Note: If you are using a RevCent Hosted WooCommerce, a RevCent Hosted Page or the RevCent WordPress Plugin then the Kount session ID is automatically retrieved without any intervention on your part. You can skip this section on Kount Session ID.
¶ Using The RevCent API
If you are submitting sale requests directly to RevCent via our API you must provide RevCent with the related Kount session ID. You provide the Kount Session ID using the metadata field in the API request. Read detailed documentation on submitting a sale request using the RevCent API.
¶ Request Metadata
When submitting a sale request, include the "kount_session_id" object in your request metadata array. RevCent will detect the specific metadata object with name="kount_session_id" and perform the proper communication with Kount before sending the payment request to your payment processor. Provide the actual session ID in the value property as seen in the example below.
Note: Empty session IDs will result in an error from Kount. Don't worry, RevCent will still proceed to your payment processor upon a Kount error.
Example Request Metadata
"metadata":[{"name": "kount_session_id", "value": "KOUNT_SESSION_ID_HERE"}]