Risk Rating

Here you can see the risk of a transaction

Field Name	Len	Type	Req	Ver	Comments
method	N/A	Alp-Num	Yes	1.2	riskRating
fromEmail	N/A	Alp-Num	Yes	1.2	The email associated with the account from which the authorize is made
merchantAccountId	N/A	Num	Yes	1.2	Acquiring Merchant ID
clientIp	N/A	Alp	Yes	1.2	The IP address of the customer placing the order
clientUserAgent	N/A	Alp-Num	--	1.2	The User-Agent HTTP header
clientAcceptLanguage	N/A	Alp-Num	--	1.2	The Accept-Language HTTP header
transactionId	N/A	Alp-Num	Yes	1.2	label.field.binTransactionId
transactionAmount	N/A	Num	Yes	1.2	The amount of the authorize transaction
transactionCurrency	3	Alp	Yes	1.2	The amount currency(e.g. USD)
billingName	N/A	Alp	Yes	1.2	The name of the customer
billingCardType	1	Num	Yes	1.2	Card Type 1 = Card type 1 2 = Card type 2
billingCardBin	6	Num	Yes	1.2	label.field.billingCardBin
billingCity	N/A	Alp-Num	Yes	1.2	Billing City
billingState	2/3	Alp-Num	Yes	1.2	Billing State - two/tree letters state / province / county code (ISO 3166-2)
billingCountry	2	Alp-Num	Yes	1.2	Billing Country - two letters country code (ISO Char 2 Code)
billingZip	N/A	Alp-Num	Yes	1.2	Billing Zip (Postal Code)
billingPhone	N/A	Num	--	1.2	Billing Phone
billingEmail	N/A	Alp-Num	--	1.2	Billing Email
shippingStreetName	N/A	Alp-Num	Yes	1.2	Shipping Street Name. Only pass this field when shipping physical goods.
shippingStreetNumber	N/A	Alp-Num	Yes	1.2	Shipping Street Number. Only pass this field when shipping physical goods.
shippingBuilding	N/A	Alp-Num	--	1.2	Shipping Building. Only pass this field when shipping physical goods.
shippingEntrance	N/A	Alp-Num	--	1.2	Shipping District. Only pass this field when shipping physical goods.
shippingFloor	N/A	Alp-Num	--	1.2	Shipping Floor. Only pass this field when shipping physical goods.
shippingApartment	N/A	Alp-Num	--	1.2	Shipping Apartment. Only pass this field when shipping physical goods.
shippingDistrict	N/A	Alp-Num	--	1.2	Shipping District. Only pass this field when shipping physical goods.
shippingCity	N/A	Alp-Num	--	1.2	Shipping City. Only pass this field when shipping physical goods.
shippingState	2/3	Alp-Num	--	1.2	Shipping State - two/tree letters state / province / county code (ISO 3166-2). Only pass this field when shipping physical goods.
shippingCountry	2	Alp-Num	--	1.2	Shipping Country - two letters country code (ISO Char 2 Code). Only pass this field when shipping physical goods.
shippingZip	N/A	Alp-Num	--	1.2	Shipping Zip (Postal Code). Only pass this field when shipping physical goods.
key	N/A	Alp-Num	Yes	1.2	MD5(sharedSecret + mechantAccountId + clientIp + clientUserAgent* + clientAcceptLanguage* + transactionId + transactionAmount + transactionCurrency + billingName + billingCardType + billingCardBin + billingCity + billingState + billingCountry + billingZip + billingPhone* + billingEmail* + shippingStreetName* + shippingStreetNumber* + shippingBuilding* + shippingEntrance* + shippingFloor* + shippingApartment* + shippingDistrict* + shippingCity* + shippingState* + shippingCountry* + shippingZip*)

This request is responded by a message with the following content:

Field Name	Len	Type	Mdt	Ver	Comments
ResponseCode	N/A	Alp-Num	Yes	1.2	The response code; 00 = Success;
ResponseDescription	N/A	Alp-Num	Yes	1.2	Human readable response
Fee	N/A	Real	Yes	1.2	Fee for the current transaction
TransactionId	N/A	Num	Yes	1.2	The Accept-Language HTTP header
Verification/RiskScore	N/A	Num	Yes	1.2	The risk score of the transaction. Value can be from 0 to 100. A higher score indicates a higher risk of fraud. We never return a risk score of 0, since all transactions have the possibility of being fraudulent.
Verification/Distance	N/A	Num	Yes	1.2	The distance from the IP address location - to the billing location, in kilometers. A higher distance indicates a higher risk of fraud.
Verification/BinName	N/A	Alp-Num	Yes	1.2	The name of the bank which issued the card. This is available for approximately 96% of all BIN numbers.
Verification/BinMatch	N/A	Alp-Num	Yes	1.2	This field can be either 1 = Yes, 0 = No, 2 = NotFound, or 3 = NA It indicates whether the credit card’s bank is in the same country as the user’s billing address.The NotFound response means that we could not find a match for the provided bin input field. The NA response means that you did not provide a bin in the input.
Verification/BinCountry	N/A	Alp-Num	Yes	1.2	The two letter ISO 3166 country code for the bank. This is available for approximately 99% of all BIN numbers.
Verification/CountryCode	N/A	Alp-Num	Yes	1.2	A two-character ISO 3166-1 country code for the country associated with the IP address.
Verification/CountryMatch	N/A	Alp-Num	Yes	1.2	This field can be either 1 = Yes or 0 = No. It indicates whether the country of the IP address matched the billing address country. A mismatch indicates a higher risk of fraud.
Verification/ProxyScore	N/A	Alp-Num	Yes	1.2	A score indicating the likelihood that the user’s IP address is an open proxy.
Verification/CarderEmail	N/A	Alp-Num	Yes	1.2	This field can be either 1 = Yes or 0 = No. It indicates whether the user’s email address is in a database of known high risk emails.

Request Sample:

https://secure.paxum.com/payment/api/paymentAPI.php
POST
method=riskRating&fromEmail=payer%40domain.com&merchantAccountId=123456&clientIp=127.0.0.1&clientUserAgent=&clientAcceptLanguage=&transactionId=225845&transactionAmount=0.08&transactionCurrency=USD&billingName=John+Doe&billingCardType=1&billingCardBin=123456&billingCity=New+York&billingState=NY&billingCountry=US&billingZip=123456&billingPhone=0123456789&billingEmail=payeer%40domain.com&shippingCountry=sCountry&shippingState=sState&shippingCity=sCity&shippingStreetName=sStreetName&shippingStreetNumber=sStreetNumber&shippingBuilding=sStreetBuilding&shippingEntrance=sStreetEntrance&amp;shippingFloor=sStreetFloor&shippingApartment=sStreetApartment&shippingDistrict=sStreetDistrict&shippingZip=sZip&key=812c8ab6e22b23bd334268ec6c1f5b06

Response Sample

<?xml version="1.0"?>
<Response>
    <Environment>PRODUCTION</Environment>
    <Method>riskRating</Method>
    <ResponseCode>00</ResponseCode>
    <ResponseDescription>Approved or Completed Successfully</ResponseDescription>
    <TransactionId>MER616GV</TransactionId>
    <Verification>
    <RiskScore>49.39</RiskScore>
    <Distance>6891</Distance>
    <BinName>3</BinName>
    <BinMatch>0</BinMatch>
    <BinCountry>US</BinCountry>
    <CountryCode>BR</CountryCode>
    <CountryMatch>0</CountryMatch>
    <ProxyScore>0</ProxyScore>
    <CarderEmail>0</CarderEmail>
    </Verification>
</Response>

Working Sample(s):

riskRating.php