Set Limit

Creates or updates transaction limits for operations. Can set system-wide limits or customer-specific limits for various operation types and payment methods.

Endpoint

POST/v2/billing/limits

Link

Gateway APIstagep.tst-apidmndelss.com

Request

Headers

Key	Value	Required
Authorization	Bearer <JWT>	Yes
Content-Type	application/json	Yes
Accept	application/json	Yes

Request Body (JSON)

Field	Type	Description & Requirements	Required	Example
id	integer	Limit ID - limit number associ	No	101
customerId	string	Customer ID for customer-specific limits. Omit for system limits.	No	"cust_12345"
currencyIsoFrom	string	Source currency (ISO 4217).	Yes	"USD"
currencyIsoTo	string	Target currency (ISO 4217).	Yes	"EUR"
operationType	string	Operation type: - NOTSET - DEPOSIT - TRANSFER - WITHDRAW - COMMISSION - EXCHANGE - CORRECTING	Yes	"TRANSFER"
paymentType	string	Payment method: - NOT_SET - EMPTY - ACH - FEDWIRE - SWIFT - CRYPTO - EFT - SEPA_CT - IMPS	Yes	"SWIFT"
min	number	Minimum amount allowed.	Yes	10.0
max	number	Maximum amount allowed.	Yes	5000.0

Example Request Body (System Limit):

{
  "currencyIsoFrom": "USD",
  "currencyIsoTo": "EUR",
  "operationType": "TRANSFER",
  "paymentType": "SWIFT",
  "min": 50.0,
  "max": 10000.0
}

Example Request Body (Customer-Specific Limit):

{
  "customerId": "cust_12345",
  "currencyIsoFrom": "USD",
  "currencyIsoTo": "USD",
  "operationType": "WITHDRAW",
  "paymentType": "ACH",
  "min": 100.0,
  "max": 2500.0
}

Example Request Body (Update Existing Limit):

{
  "id": 101,
  "currencyIsoFrom": "USD",
  "currencyIsoTo": "EUR",
  "operationType": "TRANSFER",
  "paymentType": "SWIFT",
  "min": 100.0,
  "max": 15000.0
}

---

Response (200 OK)

Returns the created or updated limit configuration.

Response Fields

Field	Type	Description	Example
id	integer	Unique limit identifier.	101
owner	integer	Owner ID (system=0, customer>0).	15
currencyIsoFrom	string	Source currency.	"USD"
currencyIsoTo	string	Target currency.	"EUR"
operationType	string	Operation type.	"TRANSFER"
paymentType	string	Payment method.	"SWIFT"
min	number	Minimum amount.	50.0
max	number	Maximum amount.	10000.0
createdAt	string	Creation timestamp (ISO 8601).	"2024-01-15T10:30:00Z"
updatedAt	string	Last update timestamp.	"2024-05-21T14:45:00Z"
customerName	string	Customer name (if applicable).	"John Doe"
customerId	string	Customer ID (if applicable).	"cust_12345"

Example Response (System Limit):

{
  "item": {
    "id": 101,
    "owner": 0,
    "currencyIsoFrom": "USD",
    "currencyIsoTo": "EUR",
    "operationType": "TRANSFER",
    "paymentType": "SWIFT",
    "min": 50.0,
    "max": 10000.0,
    "createdAt": "2024-05-21T14:45:00Z",
    "updatedAt": "2024-05-21T14:45:00Z",
    "customerName": "",
    "customerId": ""
  }
}

Example Response (Customer Limit):

{
  "item": {
    "id": 102,
    "owner": 15,
    "currencyIsoFrom": "USD",
    "currencyIsoTo": "USD",
    "operationType": "WITHDRAW",
    "paymentType": "ACH",
    "min": 100.0,
    "max": 2500.0,
    "createdAt": "2024-05-21T14:45:00Z",
    "updatedAt": "2024-05-21T14:45:00Z",
    "customerName": "John Doe",
    "customerId": "cust_12345"
  }
}

---

Examples

Request (Create Crypto Limit)

curl -X POST 'https://stagep.tst-apidmndelss.com/v2/billing/limits' \
  -H 'Authorization: Bearer eyJhbGci...wNLGA' \
  -H 'Content-Type: application/json' \
  -d '{
    "currencyIsoFrom": "BTC",
    "currencyIsoTo": "BTC",
    "operationType": "WITHDRAW",
    "paymentType": "CRYPTO",
    "min": 0.001,
    "max": 10.0
  }'

Request (Update Existing Limit)

curl -X POST 'https://stagep.tst-apidmndelss.com/v2/billing/limits' \
  -H 'Authorization: Bearer eyJhbGci...wNLGA' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": 101,
    "currencyIsoFrom": "USD",
    "currencyIsoTo": "EUR",
    "operationType": "TRANSFER",
    "paymentType": "SWIFT",
    "min": 100.0,
    "max": 20000.0
  }'

---

Error Responses

1. Invalid Amounts:

   { "error": "Minimum amount cannot exceed maximum amount" }

2. Customer Not Found:

   { "error": "Customer not found: cust_99999" }

3. Duplicate Limit:

   { "error": "Limit already exists for this configuration" }

---

Notes

• Create vs Update:

  • Include id to update existing limit
  • Omit id to create new limit
• Customer Limits: Take precedence over system limits for the same customer
• Validation: Minimum must be less than or equal to maximum
• Currency Pairs: Use same currency for single-currency operations

Real request "{ ""id"": 2378, ""customerId"": ""DaKFXt2-1vfp-e00RmYfclJTS"", ""currencyCodeFrom"": ""USD"", ""currencyCodeTo"": ""USD"", ""operationType"": ""TRANSFER"", ""paymentType"": ""EMPTY"", ""min"": 1000, ""max"": 2000 }"

Real response

"{ ""item"": { ""id"": 2378, ""owner"": 232, ""currencyCodeFrom"": ""USD"", ""currencyCodeTo"": ""USD"", ""operationType"": ""TRANSFER"", ""paymentType"": ""EMPTY"", ""min"": 1000, ""max"": 2000, ""createdAt"": ""2025-11-09T05:10:58Z"", ""updatedAt"": ""2025-11-09T05:10:58Z"", ""customerName"": """", ""customerId"": """" } }"