close
    Contents

    Risk Thresholds

    Risk Thresholds can be used by merchants to block certain high-risk transactions. With this service, we determine the risk of each transaction using a number of monitoring elements such as geolocation checks, proxy detection, IP tracking, and Bank Identification Number checks. Based on this evaluation, transactions are assigned a risk score between 0.01 and 100. The risk score represents the percentage of probability that the transaction is fraudulent. For example, a score of 10 represents a 10% possibility that the transaction is fraudulent. A score of 90 represents a 90% possibility the transaction is fraudulent.

    If a transaction is assigned a risk score greater than or equal to the threshold set in the decline field, the transaction is not processed. You will receive an email message for transactions with a risk score lower than the decline threshold but greater than or equal to the warn threshold.

    Merchants using the API must use security authentication and include the customer IP (customer_ip) to ensure an accurate risk score output. This is done automatically when using the payment form when billing address is required.

    Required fields for transactions

    To get an accurate Risk Threshold result, there are several minimally required fields in the transaction. Where possible, the merchant should send us the information in these fields to generate the most useful riskScore.

    Parameter Field Name
    Country country
    Postal Code postal_code
    City city
    Email Address email_address
    Customer IP address customer_ip

    Setting a risk threshold

    Based on millions of evaluated transactions, the table below shows a breakdown of how many transactions by percentage, that make up the different score ranges. You can use this data to help you better determine the thresholds that are appropriate for your business, based on your comfort level with the number of transactions that could be blocked.

    Risk score range Percent of orders in range
    0.10 – 4.99 90%
    5.00 – 9.99 5%
    10.00 – 29.99 3%
    30.00 – 99.99 2%

    In the decline and warn fields, you can enter up to three digits and two decimal places (minimum 0.01; maximum 100).

    1. Log in to the Online Member Area
    2. On the menu, click administration> account settings> risk thresholds. risk-threshold-settings-screenshot
    3. The default for the decline field is 60. You have the option to change it and enter the maximum risk score you will accept. Transactions with a score higher than this number are automatically rejected.
    4. The default for the warn field is 30. You have the option to change it and enter the maximum risk score that you will accept before you are sent an email with a warning message.
    5. Click Update to save your changes.

    API response

    A risk score is returned in the response object for all purchase and pre-auth transactions (response.risk_score). A transaction will be declined if the risk score is above the threshold configured in the Back Office. A transaction that was declined due to excess risk will have a response.message_id of 558.