Set limits

POST

https://api.freedompay.kz/v5/card-api/limits/set

The method is designed to set limits on financial operations for a specific object — a card, account, or client. Limits allow controlling and restricting a user's financial activity in various scenarios: by transaction type, period, currency, and transaction method (e.g., with or without 3DS authentication).
For example, for a card ("type": "card"), you can set a maximum limit ("type": "max") on the amount of cash withdrawals at ATMs ("transaction_type": "withdrawal_atm") per month ("period": "month").

Request

Body Params application/json

Example

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "object": {
    "type": "card",
    "value": "123456789"
  },
  "limits": [
    {
      "transaction_type": "withdrawal_atm",
      "period": "month",
      "amount": [
        {
          "type": "max",
          "value": "5000",
          "currency": "USD"
        }
      ]
    }
  ]
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.freedompay.kz/v5/card-api/limits/set' \
--header 'Content-Type: application/json' \
--data-raw '{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "object": {
    "type": "card",
    "value": "123456789"
  },
  "limits": [
    {
      "transaction_type": "withdrawal_atm",
      "period": "month",
      "amount": [
        {
          "type": "max",
          "value": "5000",
          "currency": "USD"
        }
      ]
    }
  ]
}'

Responses

🟢200Success

application/json

Body

Example

{
    "status": "string",
    "request_status": "string",
    "dt": "2019-08-24T14:15:22Z"
}

Modified at 2025-07-01 05:07:54

Cardholder validation

Limits list