Maximum spending limit.
Defines the maximum limit for the control. Its meaning depends on the flex control type.
- For
spending_limit controls, max_limit represents the maximum spending amount allowed.
- For
usage_limit controls, max_limit represents the maximum number of transactions allowed.
Once met or exceeded, any subsequent transactions are declined by evaluation control flow.
For spending limits, note that this value is an integer. Since global currencies vary in the number of digits that are allowed after the decimal point, you must convert the actual maximum spending limit into an integer value to use in this field. To do this, use the following formula.
value = floatNumber × 10^X, where X is the number of digits after the decimal separator for the currency as defined in ISO 4217.
For example, if you want to set the value 499.99 for BRL currency transactions, where the number of decimal places is 2, you must set it to 49999 (499.99 × 10²).
If you want to set the value 499 for JPY currency transactions, where the number of decimal places is 0, you must set it to 4999 (4999.0 × 10^0 = 4999.0 × 1 - in other words, the value doesn't change.)
This field is REQUIRED for flex controls with the type of spending_limit and usage_limit, and it does not apply to flex controls with the type of restriction and cumulative_limit.