Setting Your Beagle Rules
Once you have activated Beagle, you will need to set the anti-fraud rules that best
suit your own business model.
The following rules can be set by merchants to provide the level of fraud detection
they need:
|
Country Matching |
Block transactions where the country of the IP address does not match the billing
address. |
Block/Allow |
|
Australia Only Transactions |
Block transactions where the country of the of the card issue, billing address of
IP Address are not Australia. |
Block/Allow |
|
High Risk Country |
Block transactions where the IP address country or billing address country is in
a commonly regarded high-risk country (Egypt, Ghana, Indonesia, Lebanon, Macedonia,
Morocco, Nigeria, Pakistan, Romania, Serbia and Montenegro, Ukraine, or Vietnam). |
Block/Allow |
|
Anonymous Proxy |
Block transactions where IP address is Anonymous Proxy - Anonymous Proxies are used
to attempt to bypass Geolocation controls (anonymous proxy = very high risk). |
Block/Allow |
|
Transparent Proxy |
Block transactions where IP address is in our database of known transparent (high
risk) proxy servers. |
Block/Allow |
|
Free Email |
Block transactions where Email is from a free e-mail provider. |
Block/Allow |
If a rule is set to be Block and a transaction breaches that rule, the transaction
will be not be sent to your merchant bank for processing. As a merchant, you can
also set a notification method for whenever each rule is breached. You can be notified
by email and/or SMS, or not at all. This gives merchants the opportunity to contact
the customer to determine if they are a bona fide purchaser, and refund them if
they feel the transaction may be risky.
The above rules can be set in the eWAY Business Centre.
Using Beagle Platinum in Real-Time
To utilise Beagle, some additional information to our standard gateways must be
passed to the Beagle gateway. Beagle is currently only available via an XML Gateway.
For the technical details on the Beagle XML Gateway, including field specifications
and definitions, sample code and test account procedures, please see the Beagle
XML Payment Technical Support Pages.
Viewing Beagle Details
The following informatin is recorded by Beagle, and can be viewed in the details
of each transaction when Beagle is enabled by a merchant:
|
Geographical & IP Address Location Checks |
|
Country Match
|
Yes or No |
Whether country of IP address matches billing address country (mismatch = higher
risk) |
|
Country Code |
Two-letter ISO-3166 code |
Country Code of the IP address |
|
High Risk Country |
Yes or No |
Whether IP address or billing address country is in Egypt, Ghana, Indonesia, Lebanon,
Macedonia, Morocco, Nigeria, Pakistan, Romania, Serbia and Montenegro, Ukraine,
or Vietnam. |
|
Distance |
Rounded integer |
Distance from IP address to Billing Location in kilometers (large distance = higher
risk)
|
|
IP Region |
Two character string ISO-3166-2/FIPS 10-4 code |
Estimated State/Region of the IP address, ISO-3166-2/FIPS 10-4 code |
|
IP City |
String |
Estimated city of the IP address |
|
IP Latitude |
Degrees |
Estimated latitude of the IP address |
|
IP Longitude |
Degrees |
Estimated longitude of the IP address |
|
IP ISP |
String |
ISP of the IP address |
|
IP Organization |
String |
Organization of the IP address |
|
Proxy Detection |
|
Anonymous Proxy |
Yes or No |
Whether IP address is an anonymous proxy (anonymous proxy = very high risk) |
|
Proxy Score |
Decimal from 0 to 10 |
Likelihood of IP Address being an Open Proxy |
|
Transparent Proxy |
Yes or No |
Whether IP address is in our database of known transparent proxy servers, returned
if forwarded IP is passed as an input |
|
E-mail Checks |
|
Free Mail |
Yes or No |
Whether e-mail is from free e-mail provider (free e-mail = higher risk) |
|
Carder Email |
Yes or No |
Whether e-mail is in database of high risk e-mails |
|
Issuing Bank BIN Number Checks |
|
BIN Country |
Two-letter ISO-3166 code
|
Country code of the bank which issued the credit card based on BIN number |
|
BIN Name |
String |
Name of the bank which issued the credit card based on BIN number. Available for
approximately 96% of BIN numbers |
|
BIN Phone |
String |
Customer service phone number listed on back of credit card. Available for approximately
75% of BIN numbers |
|
Address & Phone Number Check |
|
Shipping Forward Address |
Yes, No, or NA |
Shipping address is in database of known mail drops |
|
Beagle Platinum Scores |
|
Score |
Decimal from 0 to 10 |
Overall fraud score based on outputs listed above. This is the original fraud score,
and is based on a simple formula |
|
Explanation |
String |
A brief explanation of the score, detailing what factors contributed to it, according
to our formula |
|
Risk Score |
Decimal from 0 to 100 |
Fraud score representing the estimated probability that the order is fraud, based
off of analysis of past Beagle transactions |
In order for merchants to utilise the Beagle Anti-fraud service in real time, some
additional fields are required to be passed to the eWAY gateway:
ewayCustomerIPAddress
This field is used to pass the IP Address of the customer making the purchase. This
assists in detecting fraudulent beahaviour by allowing eWAY's Beagle to pinpoint
the physical location of the computer that the customer is using for the transaction.
This field allows Beagle to match the country related to the IP address to both
the country associated with the Credit Card issuing bank, as well as the billing
country as entered by the customer themselves. If these do not match, the transaction
may be fraudulent.
Beagle also uses this field to search in our database of known anonymous and high
risk IP's. Anonymous IP addresses are used by people to 'fake' their actual physical
location, and get around Geolocational checking, such as that performed by Beagle.
Field Specification
The customers IP address is made up of 4 numbers (each up to 3 digits long), separated
by decimal points. e.g. 202.58.56.1
This information can easily be retrieved by your web developer, as it is available
in the Server Variables of each Web page request, which can be accessed by most
programming languages.
ewayCustomerBillingCountry
This field is used to pass a 2 character country code, which relates to the billing
address which was entered by the customer making the purchase. This is used be eWAY's
Beagle to match against both the country related to the IP address and the country
associated with the Credit Card issuing bank. If these do not match, the transaction
may be fraudulent.
Field Specification
The billing country code is made up of 2 characters which correspond to a particular
country.
To assit with you integration, we have created a drop down list with all countries,
and their country code:
<Select name="countries">
<option value=" <option value="AP">Asia/Pacific Region</option>
<option value="EU">Europe</option>
<option value="AD">Andorra</option>
<option value="AE">United Arab Emirates</option>
<option value="AF">Afghanistan</option>
<option value="AG">Antigua and Barbuda</option>
<option value="AI">Anguilla</option>
<option value="AL">Albania</option>
<option value="AM">Armenia</option>
<option value="AN">Netherlands Antilles</option>
<option value="AO">Angola</option>
<option value="AQ">Antarctica</option>
<option value="AR">Argentina</option>
<option value="AS">American Samoa</option>
<option value="AT">Austria</option>
<option value="AU">Australia</option>
<option value="AW">Aruba</option>
<option value="AZ">Azerbaijan</option>
<option value="BA">Bosnia and Herzegovina</option>
<option value="BB">Barbados</option>
<option value="BD">Bangladesh</option>
<option value="BE">Belgium</option>
<option value="BF">Burkina Faso</option>
<option value="BG">Bulgaria</option>
<option value="BH">Bahrain</option>
<option value="BI">Burundi</option>
<option value="BJ">Benin</option>
<option value="BM">Bermuda</option>
<option value="BN">Brunei Darussalam</option>
<option value="BO">Bolivia</option>
<option value="BR">Brazil</option>
<option value="BS">Bahamas</option>
<option value="BT">Bhutan</option>
<option value="BV">Bouvet Island</option>
<option value="BW">Botswana</option>
<option value="BY">Belarus</option>
<option value="BZ">Belize</option>
<option value="CA">Canada</option>
<option value="CC">Cocos (Keeling) Islands</option>
<option value="CD">Congo, The Democratic Republic of the</option>
<option value="CF">Central African Republic</option>
<option value="CG">Congo</option>
<option value="CH">Switzerland</option>
<option value="CI">Cote D <option value="CK">Cook Islands</option>
<option value="CL">Chile</option>
<option value="CM">Cameroon</option>
<option value="CN">China</option>
<option value="CO">Colombia</option>
<option value="CR">Costa Rica</option>
<option value="CU">Cuba</option>
<option value="CV">Cape Verde</option>
<option value="CX">Christmas Island</option>
<option value="CY">Cyprus</option>
<option value="CZ">Czech Republic</option>
<option value="DE">Germany</option>
<option value="DJ">Djibouti</option>
<option value="DK">Denmark</option>
<option value="DM">Dominica</option>
<option value="DO">Dominican Republic</option>
<option value="DZ">Algeria</option>
<option value="EC">Ecuador</option>
<option value="EE">Estonia</option>
<option value="EG">Egypt</option>
<option value="EH">Western Sahara</option>
<option value="ER">Eritrea</option>
<option value="ES">Spain</option>
<option value="ET">Ethiopia</option>
<option value="FI">Finland</option>
<option value="FJ">Fiji</option>
<option value="FK">Falkland Islands (Malvinas)</option>
<option value="FM">Micronesia, Federated States of</option>
<option value="FO">Faroe Islands</option>
<option value="FR">France</option>
<option value="FX">France, Metropolitan</option>
<option value="GA">Gabon</option>
<option value="GB">United Kingdom</option>
<option value="GD">Grenada</option>
<option value="GE">Georgia</option>
<option value="GF">French Guiana</option>
<option value="GH">Ghana</option>
<option value="GI">Gibraltar</option>
<option value="GL">Greenland</option>
<option value="GM">Gambia</option>
<option value="GN">Guinea</option>
<option value="GP">Guadeloupe</option>
<option value="GQ">Equatorial Guinea</option>
<option value="GR">Greece</option>
<option value="GS">South Georgia and the South Sandwich Islands</option>
<option value="GT">Guatemala</option>
<option value="GU">Guam</option>
<option value="GW">Guinea-Bissau</option>
<option value="GY">Guyana</option>
<option value="HK">Hong Kong</option>
<option value="HM">Heard Island and McDonald Islands</option>
<option value="HN">Honduras</option>
<option value="HR">Croatia</option>
<option value="HT">Haiti</option>
<option value="HU">Hungary</option>
<option value="ID">Indonesia</option>
<option value="IE">Ireland</option>
<option value="IL">Israel</option>
<option value="IN">India</option>
<option value="IO">British Indian Ocean Territory</option>
<option value="IQ">Iraq</option>
<option value="IR">Iran, Islamic Republic of</option>
<option value="IS">Iceland</option>
<option value="IT">Italy</option>
<option value="JM">Jamaica</option>
<option value="JO">Jordan</option>
<option value="JP">Japan</option>
<option value="KE">Kenya</option>
<option value="KG">Kyrgyzstan</option>
<option value="KH">Cambodia</option>
<option value="KI">Kiribati</option>
<option value="KM">Comoros</option>
<option value="KN">Saint Kitts and Nevis</option>
<option value="KP">Korea, Democratic People <option value="KR">Korea, Republic of</option>
<option value="KW">Kuwait</option>
<option value="KY">Cayman Islands</option>
<option value="KZ">Kazakstan</option>
<option value="LA">Lao People <option value="LB">Lebanon</option>
<option value="LC">Saint Lucia</option>
<option value="LI">Liechtenstein</option>
<option value="LK">Sri Lanka</option>
<option value="LR">Liberia</option>
<option value="LS">Lesotho</option>
<option value="LT">Lithuania</option>
<option value="LU">Luxembourg</option>
<option value="LV">Latvia</option>
<option value="LY">Libyan Arab Jamahiriya</option>
<option value="MA">Morocco</option>
<option value="MC">Monaco</option>
<option value="MD">Moldova, Republic of</option>
<option value="MG">Madagascar</option>
<option value="MH">Marshall Islands</option>
<option value="MK">Macedonia, the Former Yugoslav Republic of</option>
<option value="ML">Mali</option>
<option value="MM">Myanmar</option>
<option value="MN">Mongolia</option>
<option value="MO">Macau</option>
<option value="MP">Northern Mariana Islands</option>
<option value="MQ">Martinique</option>
<option value="MR">Mauritania</option>
<option value="MS">Montserrat</option>
<option value="MT">Malta</option>
<option value="MU">Mauritius</option>
<option value="MV">Maldives</option>
<option value="MW">Malawi</option>
<option value="MX">Mexico</option>
<option value="MY">Malaysia</option>
<option value="MZ">Mozambique</option>
<option value="NA">Namibia</option>
<option value="NC">New Caledonia</option>
<option value="NE">Niger</option>
<option value="NF">Norfolk Island</option>
<option value="NG">Nigeria</option>
<option value="NI">Nicaragua</option>
<option value="NL">Netherlands</option>
<option value="NO">Norway</option>
<option value="NP">Nepal</option>
<option value="NR">Nauru</option>
<option value="NU">Niue</option>
<option value="NZ">New Zealand</option>
<option value="OM">Oman</option>
<option value="PA">Panama</option>
<option value="PE">Peru</option>
<option value="PF">French Polynesia</option>
<option value="PG">Papua New Guinea</option>
<option value="PH">Philippines</option>
<option value="PK">Pakistan</option>
<option value="PL">Poland</option>
<option value="PM">Saint Pierre and Miquelon</option>
<option value="PN">Pitcairn</option>
<option value="PR">Puerto Rico</option>
<option value="PS">Palestinian Territory, Occupied</option>
<option value="PT">Portugal</option>
<option value="PW">Palau</option>
<option value="PY">Paraguay</option>
<option value="QA">Qatar</option>
<option value="RE">Reunion</option>
<option value="RO">Romania</option>
<option value="RU">Russian Federation</option>
<option value="RW">Rwanda</option>
<option value="SA">Saudi Arabia</option>
<option value="SB">Solomon Islands</option>
<option value="SC">Seychelles</option>
<option value="SD">Sudan</option>
<option value="SE">Sweden</option>
<option value="SG">Singapore</option>
<option value="SH">Saint Helena</option>
<option value="SI">Slovenia</option>
<option value="SJ">Svalbard and Jan Mayen</option>
<option value="SK">Slovakia</option>
<option value="SL">Sierra Leone</option>
<option value="SM">San Marino</option>
<option value="SN">Senegal</option>
<option value="SO">Somalia</option>
<option value="SR">Suriname</option>
<option value="ST">Sao Tome and Principe</option>
<option value="SV">El Salvador</option>
<option value="SY">Syrian Arab Republic</option>
<option value="SZ">Swaziland</option>
<option value="TC">Turks and Caicos Islands</option>
<option value="TD">Chad</option>
<option value="TF">French Southern Territories</option>
<option value="TG">Togo</option>
<option value="TH">Thailand</option>
<option value="TJ">Tajikistan</option>
<option value="TK">Tokelau</option>
<option value="TM">Turkmenistan</option>
<option value="TN">Tunisia</option>
<option value="TO">Tonga</option>
<option value="TP">East Timor</option>
<option value="TR">Turkey</option>
<option value="TT">Trinidad and Tobago</option>
<option value="TV">Tuvalu</option>
<option value="TW">Taiwan, Province of China</option>
<option value="TZ">Tanzania, United Republic of</option>
<option value="UA">Ukraine</option>
<option value="UG">Uganda</option>
<option value="UM">United States Minor Outlying Islands</option>
<option value="US">United States</option>
<option value="UY">Uruguay</option>
<option value="UZ">Uzbekistan</option>
<option value="VA">Holy See (Vatican City State)</option>
<option value="VC">Saint Vincent and the Grenadines</option>
<option value="VE">Venezuela</option>
<option value="VG">Virgin Islands, British</option>
<option value="VI">Virgin Islands, U.S.</option>
<option value="VN">Vietnam</option>
<option value="VU">Vanuatu</option>
<option value="WF">Wallis and Futuna</option>
<option value="WS">Samoa</option>
<option value="YE">Yemen</option>
<option value="YT">Mayotte</option>
<option value="YU">Yugoslavia</option>
<option value="ZA">South Africa</option>
<option value="ZM">Zambia</option>
<option value="ZR">Zaire</option>
<option value="ZW">Zimbabwe</option>
<option value="A1">Anonymous Proxy</option>
<option value="A2">Satellite Provider</option>
</select>