Skip to main content

Antifraud Solutions

Antifraud solutions are essential for protecting businesses and customers from unauthorised transactions. By detecting and preventing fraud in real-time, these solutions help businesses avoid financial losses, comply with industry standards, and maintain customer trust. Securing transactions not only builds customer confidence but also strengthens brand reputation.

All Fondy solutions have antifraud protection enabled by default. Fondy uses the payment information to validate the payment's authenticity. To improve antifraud system accuracy, you can provide additional information when creating the payment using the reservation_data parameter.

Disable Antifraud

If you need to disable the antifraud feature, please contact our support team.

Improve Antifraud Accuracy

When sending purchase requests, you can include the reservation_data parameter. This parameter contains JSON-encoded data formatted in Base64 to provide additional transaction details. The information shared through the reservation_data helps improve the accuracy of the antifraud solution in identifying fraudulent transactions.

The following table lists and describes all parameters you can share using the reservation_data:

NameTypeDescriptionExample
phonemobileAN(16)Client mobile phone number.+12345678
customer_addressAN(1024)Client address.15 gannet street elspark
customer_countryAN(2)Client billing country (ISO code).US
customer_stateAN(1024)Client state.NY
customer_nameAN(1024)Client name.Brandon Nyathi
customer_cityAN(1024)Client city.New York
customer_zipAN(250)ZIP code.1401
accountAN(250)Client account ID in merchant system.id32648480
uuidAN(250)Device UUID.00002415-0000-1000-8000-00805F9B34FB
fields_customJSONJSON list of additional fields to be displayed on checkout.

The following code block presents an example of a JSON object:

{
"phonemobile": "+12345678",
"customer_address": "15 gannet street elspark",
"customer_country": "US",
"customer_state": "NY",
"customer_name": "Brandon Nyathi",
"customer_city": "New York",
"customer_zip": "1401",
"account": "id32648480",
"uuid": "00002415-0000-1000-8000-00805F9B34FB"
}
Custom Checkout Fields

The fields_custom object allows you to add custom input fields to the checkout page.

"fields_custom": [
{
"name": "id-1",
"label": "label1",
"value": "1",
"valid": {
"pattern": "^[0-9]+$",
"max_length": 222,
"min_length": 10
},
"readonly": false,
"required": true,
"type": "input",
"p": 1
},
{
"name": "id-2",
"label": "label2",
"value": "",
"p": 2
},
{
"name": "id-3",
"label": "label3",
"type": "checkbox",
"required": true,
"p": 3
}
]
Parameter Format Requirements

All parameters must be alphanumeric and use Latin characters, digits, and separator symbols.

After defining the object with the additional information, you must encode it into Base64. Below is an example of encoded data in Base64 using the information from the above code block:

ewogICJwaG9uZW1vYmlsZSI6ICIrMTIzNDU2NzgiLAogICJjdXN0b21lcl9hZGRyZXNzIjogIjE1IGdhbm5ldCBzdHJlZXQgZWxzcGFyayIsCiAgImN1c3RvbWVyX2NvdW50cnkiOiAiVVMiLAogICJjdXN0b21lcl9zdGF0ZSI6ICJOWSIsCiAgImN1c3RvbWVyX25hbWUiOiAiQnJhbmRvbiBOeWF0aGkiLAogICJjdXN0b21lcl9jaXR5IjogIk5ldyBZb3JrIiwKICAiY3VzdG9tZXJfemlwIjogIjE0MDEiLAogICJhY2NvdW50IjogImlkMzI2NDg0ODAiLAogICJ1dWlkIjogIjAwMDAyNDE1LTAwMDAtMTAwMC04MDAwLTAwODA1RjlCMzRGQiIKfQ==
Base64 Encoding

The Base64 string above is an example. In production, your encoded string will contain your actual transaction data.

With the encoded information, you can create a new purchase request by including the reservation_data parameter, as shown in the following example. You can use the reservation_data parameter when creating purchase requests in JSON format.

Request Example (JSON)

{
"request": {
"response_url": "https://site.com/responsepage/",
"order_id": "test_reservation_data_12345",
"order_desc": "Test payment",
"currency": "GBP",
"amount": "100",
"signature": "dcf5a9a582872bf0ba89bb77a25c3894671b423a",
"merchant_id": "1396424",
"reservation_data": "ewogICJwaG9uZW1vYmlsZSI6ICIrMTIzNDU2NzgiLAogICJjdXN0b21lcl9hZGRyZXNzIjogIjE1IGdhbm5ldCBzdHJlZXQgZWxzcGFyayIsCiAgImN1c3RvbWVyX2NvdW50cnkiOiAiVVMiLAogICJjdXN0b21lcl9zdGF0ZSI6ICJOWSIsCiAgImN1c3RvbWVyX25hbWUiOiAiQnJhbmRvbiBOeWF0aGkiLAogICJjdXN0b21lcl9jaXR5IjogIk5ldyBZb3JrIiwKICAiY3VzdG9tZXJfemlwIjogIjE0MDEiLAogICJhY2NvdW50IjogImlkMzI2NDg0ODAiLAogICJ1dWlkIjogIjAwMDAyNDE1LTAwMDAtMTAwMC04MDAwLTAwODA1RjlCMzRGQiIKfQ=="
}
}