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.
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
:
Name | Type | Description | Example |
---|---|---|---|
phonemobile | AN(16) | Client mobile phone number. | +12345678 |
customer_address | AN(1024) | Client address. | 15 gannet street elspark |
customer_country | AN(2) | Client billing country (ISO code). | US |
customer_state | AN(1024) | Client state. | NY |
customer_name | AN(1024) | Client name. | Brandon Nyathi |
customer_city | AN(1024) | Client city. | New York |
customer_zip | AN(250) | ZIP code. | 1401 |
account | AN(250) | Client account ID in merchant system. | id32648480 |
uuid | AN(250) | Device UUID. | 00002415-0000-1000-8000-00805F9B34FB |
fields_custom | JSON | JSON 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"
}
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
}
]
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==
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=="
}
}