2. Add

Used to add information to the blacklist.

Check

POST {{Base Address}}/api/v1/fraud/blacklist

It is sufficient to send a request to the address provided above. You can use the Base Address as needed for both the test and live environments.

Important: To use the Fraud – Blacklist – Add service, you must include the apikeyprivate and apiclientprivate parameters in the Header. FraudAPI Address

The header information to be sent to the service is as follows:

Parameter	Type	Compolsory	Description
apikeyprivate	string	Yes	The Private Key obtained from the merchant panel
apiclientprivate	string	Yes	The Private Client obtained from the merchant panel

Information to be sent to the service:

Parameter	Type	Compolsory	Description
EntryType	int	Yes	The type of the data to be added to the blacklist See: Types
Value	int	Yes	The value of the data to be added to the blacklist
Reason	bool	No	The reason for adding the data to the blacklist
ExpiresAt	DateTime?	No	The data to be added to the blacklist

JSON

{
    "EntryType": 1,
    "Value": "[email protected]",
    "Reason": "Çok başarısız ödeme denediği için eklendi",
    "ExpiresAt": null
}

Response returned from the service:

Parameter	Type	Description
Body	object	JSON containing detailed balance information (optional)
ErrorCode	int	Error code. Returns '0' if the operation is successful
Result	bool	Returns true or false. If the operation is successful, it returns true
Message	string	If the operation fails, it returns the relevant error message and provides language support based on the locale parameter

JSON

{
    "Value": {
        "Id": "550b5305-2a56-4577-bb2c-dbce55f6cc2a",
        "MerchantId": 2071,
        "EntryType": 1,
        "Value": "stringst****ring",
        "Reason": "string",
        "ExpiresAt": null,
        "IsPermanent": true,
        "CreatedAt": "2026-02-22T16:45:26.6801206Z",
        "IsActive": true
    },
    "IsFailure": false,
    "IsSuccess": true,
    "Error": null
}