Pass Inputs to minFraud

minFraud scoring is based on an analysis of inputs related to the transaction being scored. The more input fields you pass to the minFraud service, the more accurate the risk score will be. Learn more about the risk score.

Recommended minimum inputs

When possible, we recommend passing at least the following inputs:

Input Description API Specification (Link to Dev Documentation)
IP The IP address of the customer or end-user initiating the transaction. /device/ip_address
Billing Country The country of the billing address provided by the customer or end-user initiating the transaction. /billing/country
Billing City The city of the billing address provided by the customer or end-user initiating the transaction. /billing/city
Billing Postal The postal code of the billing address provided by the customer or end-user initiating the transaction. /billing/postal
IIN The issuer ID number (IIN) of the credit card used in the transaction. Read more about credit card IINs on Wikipedia. /credit_card/issuer_id_number
Email The email address provided by the customer or end-user initiating the transaction. /email/address
User Agent The User-Agent header of the browser used by the customer or end-user initiating the transaction. This helps minFraud services to identify and track devices that are conducting fraud across the minFraud Network. Learn more about device tracking. /device/user_agent
Browser Language The Accept-Language header of the browser used by the customer or end-user initiating the transaction. This input is used in conjunction with location indicators to see if the language being used in the browser is very unusual for the location of the transaction. /device/accept_language

You can review all of the minFraud inputs we accept in our developer documentation.

Risk scoring and risk data based on inputs

In addition to making scoring more accurate, the minFraud services will return different outputs depending on which inputs are received. For example, the minFraud services cannot return the IP risk score for transactions that do not have an IP address. Similarly, minFraud Insights and minFraud Factors cannot return IP geolocation information about the transaction if there is no IP address associated with it. minFraud Insights and minFraud Factors can return risk data and risk scoring related to email addresses, billing and shipping addresses, credit cards, and more, but only when the relevant inputs are provided.

You can see what kind of risk data and risk scores will be returned based on which inputs you send to the minFraud Insights or minFraud Factors service:

Input Sent Risk Data Returned Risk Scores Returned
IP
IP and Chargebacks
Learn more about reporting chargebacks.
--
IP and Device Tracking
Learn more about device tracking.
Device Data --
Billing Address
IIN (Issuer ID Number)
Email
Shipping Address

Payment processor inputs

If you perform AVS and CVV checks through your payment processor prior to querying the minFraud service, we recommend passing the codes for these checks to minFraud as part of your query. The API specifications for these inputs are documented on the dev site under /credit_card/avs_result and /credit_card/cvv_result.

This page was last updated on .

Was this article helpful?