💸

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

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).

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.

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

Last modified 26d ago