Fraud Check

Create a fraudcheck

post

/{sid}/fraudcheck

Path parameters

sidintegerrequired

ID of site

Body

hashstringrequired

md5 hash of sid+timestamp+amounttotal+currency+rcode e.g. md5('22'.'1234568995265421'.'17.00'.'USD'.'222b6c')

timestampstringrequired

timestamp value used in the hash e.g. 1234568995265421

tidstring

Merchant reference

card_typeinteger · int64required

type of card(visa/mastercard)

card_nointeger · int64required

The card number or the bin

card_exp_monthstringrequired

2 digit for the month. Please have leading zeroes e.g. 05

card_exp_yearstringrequired

4 digit year i.e. 2016

card_namestringrequired

The name printed on the card

card_ccvnumberrequired

Card CCV

bank_namestring

The name of the bank

bank_phonestring

Bank phone number

routing_nostring

Bank routing number

mobilestring

Mobile number

useragentstring

string identifying the software acting on behalf of a user to interact with web servers

browseragentstring

string helps identify which browser is being used, what version, and on which operating system

dynamic_descriptorstring

Business name as it appears on the customer's bank statement

fingerprintsessionstring

device fingerprint (Unique identifier for the session)

threeDSecurestring

json string containing 3ds2 check values

device_infostring

json string containing device information check values

firstnamestringrequired

First name of the customer.

lastnamestringrequired

Last name of the customer.

emailstringrequired

Email of the customer.

phonestring

Phone of the customer.

addressstring

Billing street address

suburb_citystring

Billing suburb or city

statestring

Billing state, 2 letter code for US/Canada. Australia should use 2/3 letter codes.

countrystring

Billing country, ISO 3166 2 digit code.

postcodestring

Billing postcode/zipcode.

ship_addressstring

Shipping street address

ship_suburb_citystring

Shipping suburb or city

ship_statestring

Shipping state, 2 letter code for US/Canada. Australia should use 2/3 letter codes.

ship_countrystring

Shipping country, ISO 3166 2 letter code.

ship_postcodestring

Shipping postcode/zipcode.

amountanyrequired

Amount

currencystringrequired

Transaction currency, ISO 3 letter code

uipstring

users ip address

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '<?=PROTOCOL?>://<?=SITE_DOMAIN?>/api/v1/index.php/{sid}/fraudcheck' \
  --header 'Content-Type: multipart/form-data' \
  --form 'hash=text' \
  --form 'timestamp=text' \
  --form 'tid=text' \
  --form 'card_type=1' \
  --form 'card_no=1' \
  --form 'card_exp_month=text' \
  --form 'card_exp_year=text' \
  --form 'card_name=text' \
  --form 'card_ccv=1' \
  --form 'bank_name=text' \
  --form 'bank_phone=text' \
  --form 'routing_no=text' \
  --form 'mobile=text' \
  --form 'useragent=text' \
  --form 'browseragent=text' \
  --form 'dynamic_descriptor=text' \
  --form 'fingerprintsession=text' \
  --form 'threeDSecure=text' \
  --form 'device_info=text' \
  --form 'firstname=text' \
  --form 'lastname=text' \
  --form 'email=text' \
  --form 'phone=text' \
  --form 'address=text' \
  --form 'suburb_city=text' \
  --form 'state=text' \
  --form 'country=text' \
  --form 'postcode=text' \
  --form 'ship_address=text' \
  --form 'ship_suburb_city=text' \
  --form 'ship_state=text' \
  --form 'ship_country=text' \
  --form 'ship_postcode=text' \
  --form 'amount=null' \
  --form 'currency=text' \
  --form 'uip=text'

200

default

200

{
  "sid": 1,
  "comment": "text",
  "tid": "text",
  "card_issuer": "text",
  "txid": 1,
  "status": "text",
  "tx_action": "text",
  "amount": 1,
  "currency": "text",
  "pay_method": "text",
  "error": [],
  "cardbindata": [],
  "fraud_checks": "text"
}

Fraudcheck result