Links
💸

Payment Fraud Prevention

Prevent financial losses by deploying AI-Powered modules

Overview

Detecting and preventing fraudulent payments is a critical task for any business that accepts online payments. This AI-based module is designed to help you do that by analysing a range of data points related to each transaction.
Using sophisticated machine learning algorithms, this method can detect and flag potentially fraudulent transactions by analysing user data, user behaviour, user device, and other factors. For example, if a transaction appears to be coming from an unusual location or device, or if the user's behaviour is inconsistent with their past transactions, this method can flag the transaction for further review or rejection.
One of the key advantages of this AI-based module is its ability to adapt and learn over time. As it analyses more data and detects more fraud, it can improve its accuracy and efficiency, making it a highly effective tool for preventing financial losses due to fraud.
By implementing this method in your payment processing system, you can help protect your business and your customers from fraudulent activity, while providing a seamless and secure payment experience.
"ECOMMERCE LOSSES TO ONLINE PAYMENT FRAUD TO EXCEED $48 BILLION GLOBALLY IN 2023, AS FRAUD INCURSIONS EVOLVE", according to a recent report by Juniper Research.

Integration Workflow

Greip Payment Fraud Module - Workflow

Module Integration

post
https://gregeoip.com
/paymentFraud
Method endpoint.

Method Parameters

Here's a list of all parameters can be used for this method:
Parameter
Description
key *
Your API Key.
data *
The data of the customer transaction.
format
The format of the API response. (JSON or XML)
callback
Tells the API to return the response as a callback function (Check out Callback section).
mode
Lets you use our Development Environment to test the API without affecting your available requests (Learn more).
All parameters with (*) are required.

Data Object Parameters

Parameter
Value Type
Description
action
String
The action your customer try to implement. Accepts: purchase, deposit, or withdrawal.
website_domain
String
The domain name of the website the customer trying to purchase from. Example: domain.com
website_name
String
The name of the website the customer trying to purchase from. Example: Nike Store, California
merchant_id
String or Integer
If your a service provider with "sub-websites" (like Shopify), then provide a unique identification code indicating the website the customer trying to purchase from. Examples: 12330098 01as-aowq-029jd abcdefg
shipment_id
String or Integer
The identification code of the shipment.
transaction_id
String or Integer
The identification code of the transaction in your system.
transaction_amount
String or Float
The total amount of the transaction.
transaction_currency
String
The currency in which the customer pay with. Examples: GBP, USD, SAR, EUR, etc.
cart_items
Object
A key-value object of the cart items. Accepted keys: item_id, item_name, item_quantity, item_price, and item_category_id.
isDigitalProducts
Boolean
Set this to true if the customer is purchasing a digital product.
coupon
String
The promo code used by the customer to complete the checkout.
customer_id
String or Integer
The identification number of the customer in your system.
customer_firstname
String
The first name of the customer.
customer_lastname
String
The last name of the customer (Family Name).
customer_pob
String
The Place of Birth of the customer.
customer_ip
String
The IP Address of the customer.
customer_country
String
The ISO 3166-1 alpha-2 code format of the country where the customer live. Learn more
customer_region
String
The name of the region where the customer live.
customer_city
String
The name of the city where the customer live.
customer_zip
String or Integer
The name of the zip code of customer location.
customer_street
String
The "address line 1" of the customer.
customer_street2
String
The "address line 2" of the customer.
customer_latitude
Integer or Float
The customer latitude on the map (GPS Coordinates).
customer_longitude
Integer or Float
The customer longitude on the map (GPS Coordinates).
customer_device_id
String or Integer
The device identification code of the customer.
customer_phone
String or Integer
The phone number of the customer (international format).
customer_registration_date
Integer
The registration date of the customer (UNIX Timestamp).
customer_balance
Integer, String or Float
If you offer a Wallet feature in your website, then pass the user balance to this pararmeter.
customer_dob
String
The customer's date of birth. Example: 1985-12-27
customer_email
String
The email address of the customer.
customer_2fa
Boolean
Set this to true if the customer has 2FA enabled in his/her account.
customer_useragent
String
Pass the User Agent of the customer to this parameter.
shipping_country
String
The shipping country code of the customer (in ISO 3166-1 alpha-2 format).
shipping_region
String
The shipping region name of the customer.
shipping_city
String
The shipping city name of the customer.
shipping_zip
String or Integer
The zip code of the customer's shipping address.
shipping_street
String
The shipping "address 1" of the customer.
shipping_street2
String
The shipping "address 2" of the customer.
shipping_latitude
Integer or Float
The latitude of the customer's shipping address (GPS Coordinates).
shipping_longitude
Integer or Float
The longitude of the customer's shipping address (GPS Coordinates).
billing_country
String
The billing country code of the customer (in ISO 3166-1 alpha-2 format).
billing_region
String
The billing region name of the customer.
billing_city
String
The billing city name of the customer.
billing_zip
String or Integer
The zip code of the customer's billing address.
billing_street
String
The billing "address 1" of the customer.
billing_street2
String
The billing "address 2" of the customer.
billing_latitude
Integer or Float
The latitude of the customer's billing address (GPS Coordinates).
billing_longitude
Integer or Float
The longitude of the customer's billing address (GPS Coordinates).
payment_type
String
The payment method used to complete this transaction. Accepts: cards, cards_mada, applepay, stcpay, bank, crypto, wallet, or cod.
card_name
String
The name on the card (Cardholder Name).
card_number
String or Integer
The card number (min: 6 digits).
card_expiry
String
The expiry date of the customer debit/credit card. Example: 29/05
cvv_result
Boolean
Set this to true if the customer passed the CVV/CSV verification process.
All parameters in the data object are OPTIONAL.
But, more data provided to this module is more investigations the module will rule over the data.

Request Sample

curl --location 'https://gregeoip.com/paymentFraud' \
--header 'Content-Type: application/json' \
--data-raw '{
"key": "{{API-KEY}}",
"data": {
"action": "purchase",
"website_domain": "domain-name.com",
"merchant_id": 21,
"customer_id": 1,
"customer_ip": "1.0.0.2",
"customer_email": "[email protected]",
"transaction_amount": 100000,
"transaction_currency": "USD",
"customer_useragent": "Mozill almaden sdfwer"
}
}'

Response Sample

{
"data": {
"score": 82,
"rules": [
{
"id": "PF10003",
"description": "Customer IP Address is probably VPN/Proxy/Bot/Hosting/Cloud."
},
{
"id": "PF10004",
"description": "Customer Email Address is probably invalid or spam."
},
{
"id": "PF10001",
"description": "High purchase rate, according to `customer_ip`."
},
{
"id": "PF10002",
"description": "High purchase rate, according to `customer_id`."
},
{
"id": "PF10013",
"description": "Customer device might not be a real device (according to `customer_useragent`)."
},
{
"id": "PF10014",
"description": "Customer device is registered as a high-risk device (according to `customer_useragent`)."
}
],
"rulesChecked": 21,
"rulesDetected": 6
},
"status": "success",
"executionTime": 5
}

Response Possible Values

Key
Values
data.score
Float
data.rules
Array
data.rulesChecked
Integer
data.rulesDetected
Integer