Fraud prevention

Solidgate API for fraud prevention enables merchants to set up and manage fraud prevention lists, helping to block fraudulent activities while ensuring secure transactions.

By configuring fraud prevention lists, merchants can define specific conditions to allow or reject transactions, enhancing the security and reliability of their payment operations.

Operations

Create fraud prevention list items

Request

This method allows you to add new items to fraud prevention list linked to the merchant's account.

Security

merchant and signature

merchantstringrequired

Unique public key provided upon registration and must be shared for identification purposes.

Example:api_pk_7b197...ba108f842

signaturestringrequired

Request signature that allows verification of merchant authenticity on the payment gateway server.

Example:M2E3OTkyNzcz...xMmExODI4

Bodyapplication/json

itemsArray of objects, <= 100 itemsrequired

List of fraud prevention list items to be created.

POST

/fraud-prevention-list-items/create

curl -i -X POST \
  https://risks.solidgate.com/api/v1/fraud-prevention-list-items/create \
  -H 'Content-Type: application/json' \
  -H 'merchant: YOUR_API_KEY_HERE' \
  -H 'signature: YOUR_API_KEY_HERE' \
  -d '{
    "items": [
      {
        "list_type": "pass",
        "payment_field": "card_id",
        "field_value": "923bb4e6-4a5f-41ec-81fb-28eb8a152e55",
        "expired_at": "2025-12-21 11:21:30",
        "description": "This is a pass rule",
        "created_by": "email@email.com"
      },
      {
        "list_type": "reject",
        "payment_field": "ip_address",
        "field_value": "123.123.123.123",
        "description": "This is a reject rule"
      }
    ]
  }'

Responses

Request received

Bodyapplication/json

Any of:

itemsArray of objectsrequired

List of created fraud prevention list items.

Response

{
  "items": [ … ]
}