Input and Output Parameters
Function: GetDetailedRiskScore(string UserName, string Password,
string IPAddress_P1, string FullAddress_P2, string EmailAddress, string CardLast4, string CardCcv, string CardExpMo, string CardExpYr, string Memo)
Returns: DetailedRiskScore object
Click here to see C# Sample code.
Input
| Name |
Type |
Description |
| UserName |
string |
Your FraudSmack account username. |
| Password |
string |
Your FraudSmack account password. |
| IPAddress_P1 |
string |
IP Address (ie: 123.123.123.123) of your customer. |
| FullAddress_P2 |
string |
5 part comma delimited string of:
street address
city
state
zipcode
2 letter country code (ISO 3166 country code) |
| EmailAddress |
string |
Email address of your customer. |
| CardBin |
string |
The first 6 digits of the credit card number. |
| CardLast4 |
string |
The last 4 digits of the credit card number. |
| CardCcv |
string |
The security code of the credit card (Card Code Verification). |
| CardExpMo |
string |
The 1 or 2 digit number of the credit card's expiration date. |
| CardExpYr |
string |
The 1 or 2 or 4 digit number of the credit card's expiration date. All 3 of the following would be acceptable: "9", "09", or "2009". |
| Memo |
string |
We suggest using this field for a transaction ID. |
Output
The web service call will return a DetailedRiskScore object. The table below shows all the properties of the DetailedRiskScore.
The main field of interest is 'o_Result'. The other fields can be used to gain detailed
information.
| Name |
Type |
Description |
| o_Result |
string |
"ACCEPT", "WARN", "DENY", "ERROR" |
| o_TotalPoints |
decimal |
The total point value of all RiskFactors (see below). |
| o_BlackListed |
bool |
True, if any of the RiskFactors scored as blacklisted. (DENY) |
| o_GrayListed |
bool |
True, if any of the RiskFactors scored as graylisted. (WARN) |
| o_Whitelisted |
bool |
True, if any of the RiskFactors scored as whitelisted. (ACCEPT) |
| i_Email |
string |
Input email address. |
| i_Point1_IP |
string |
Input IP address |
| i_Point2_FullAddress |
string |
Input 5 part comma delimited string of the full address. |
| i_CardBin |
string |
Input first 6 digits of credit card |
| i_CardLast4 |
string |
Input last 4 digits of credit card |
| i_CardExpMo |
string |
Input expiration month. |
| i_CardExpYr |
string |
Input expiration year. |
| i_CardCcv |
string |
Input credit card security code. |
| i_Memo |
string |
Your memo input. Generally used for a transaction identifier. |
| o_QueryID |
string |
32 digit unique identifer (GUID) generated to identify the query. |
| o_AnonProxy |
bool |
Is the customer hiding behind an open/anon. proxy. |
| o_CentralISP |
bool |
Is the customer using AOL or other major central ISP. |
| o_CountryNoMatch |
bool |
If true, countries don't match. |
| o_CountryOnlyMatch |
bool |
If true, coutries match but regions(or states) don't match |
| o_CountryRegionMatch |
bool |
If true, countries and regions (or states) match. |
| o_Distance_Km |
decimal |
Distance between IP address and full address if it could be calculated. If it could not be calculated, this will be -1. |
| o_Distance_Miles |
decimal |
Distance between IP address and full address if it could be calculated. If it could not be calculated, this will be -1. |
| o_Point1_CountryCode |
string |
2 character IS0 country code of the input IP address. |
| o_Point1_Lat |
decimal |
Latitude of IP address. If IP is not in our database, this will be 0. |
| o_Point1_Long |
decimal |
Longitude of IP address. If IP is not in our database, this will be 0. |
| o_Point1_Region |
string |
Region (or state) of the IP address. |
| o_Point2_CountryCode |
string |
2 character IS0 country code of the input full address. |
| o_Point2_Lat |
decimal |
Latitude of full address. If not in our database, this will be 0. |
| o_Point2_Long |
decimal |
Longitude of full address. If not in our database, this will be 0. |
| o_Point2_Region |
string |
Region (or state) of the full address. |
| RiskFactors |
collection |
| Name |
Type |
Description |
| Name |
string |
Name of the RiskFactor |
| InUse |
bool |
True, if the RiskFactor is being used. |
| Points |
decimal |
Point value of this RiskFactor. |
| BlackListed |
bool |
True, if the RiskFactor is blacklisted. (DENY) |
| GrayListed |
bool |
True, if the RiskFactor is graylisted. (WARN) |
| WhiteListed |
bool |
True if the RiskFactor is whitelisted. (ACCEPT) |
|
*Note: Country codes should be ISO 3166 codes which can be found at
http://www.iso.org/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/list-en1.html