API Info
Preventing online fraud is easy with FraudGuardian. Fraud prevention is a necessity in the current state of world wide transactions and billing. FraudGuardian, in combination with ModernBill, can provide full order and provisioning automation based on business rules easily configured within the FraudGuardian module.
FraudGuardian API:
The FraudGuardian API will allow you to integrate real-time fraud scoring into your own order form or eCommerce software. Below is a visual representation of the process the FraudGuardian API employs, in three simple steps.
IMG GOES HERE
FraudGuardian is supported in the following software products:
- ModernBill using the FraudGuardian Module and the Order Wizard
Attention Software Developers: If you add FraudGuardian support to your software, please let us know and we will add you to the list above.
FraudGuardian API Parameters:
| Parameters | Values | Description |
|---|---|---|
i |
Required (123.123.123.123) | IP Address of the Order |
domain |
Required (domain.com) | E-Mail Address Domain of the Order |
city |
Required | Card Card Billing City |
region |
Required | Credt Card Billing State or Region |
postal |
Required | Card Card Billing Postal Code |
country |
Required (ISO2) | Credit Card Billing Country |
login |
Required | Your Account E-Mail Address |
pass |
Required | Your Account Password |
do_whois |
Optional (1 or 0) | If 1, a WHOIS lookup is performed on the e-mail domain parameter. |
send_to |
Optional (E-Mail Address) | E-Mail address where the fraud score report will be sent to if different than the login parameter. |
bin |
Optional [0-9]{6} | First 6 digits of credit card; Visa & Mastercard only. |
output |
Required (score,csv,xml) | Desired output of real-time score results: 'csv' = all data on single line (except WHOIS) 'score' = feature in development 'xml' = feature in development |
| Optional (1 or 0) | Send full fraud score report via e-mail to you. | |
do_map |
Optional (1 or 0) | If set, IP will be mapped and sent via e-mail. |
var1- var7 |
Optional | Optional parameters you may pass in and will be echoed back in the fraud score report only. |
Example API Syntax
Your order form will accept and format the customer's information, then submit it to the FraudGuardian API.
http://www.example_url.com/example.php?i=12.215.198.169&domain=hotmail.com &city=Bellvue®ion=WA&postal=39402&country=US&bin=400126 &login=me@mydomain.com&pass=mypass&do_whois=0 &send_to=reports@mydomain.com&output=csv&email=1&do_map=1
Example API Response: (CSV Format)
The FraudGuardian response is sent in real-time back to your script. You can apply your own rules based on this response. Note that you will also receive a FULL fraud report via email with more detailed information.
error=;score=2.77;ipMatch=Yes;ipCountry=US;freeMail=Yes; anonProxy=No;binError=;binMatch=Yes;binCountry=US
FraudGuardian API Response Parameters:
| Parameters | Values | Description |
|---|---|---|
error |
ERROR CODE | error code, if applicable |
score |
0 - 10 | real-time fraud score on a scale of 0 - 10 |
ipMatch |
Yes or No | does IP country match billing country |
ipCountry |
ISO2 | country code of IP address |
freeMail |
Yes or No | is the e-mail address from a free e-mail service |
anonProxy |
Yes or No | is the IP address using an anonymous proxy |
binError |
ERROR CODE | error code, if applicable, to BIN number |
binMatch |
Yes or No | does BIN country match billing address |
binCountry |
ISO2 | country code of BIN (credit card) |