Card limits

Card limit related functionalities allow the DAPI user to do the following:

  • to get general information about the available card limits,
  • to get information about effective group limits and individual limits for a specific card,
  • to change individual limits.

There are two basic limit categories: group limits and individual limits. Group limits are initially set at the time of a card product's setup in the Card Management System by DECTA in accordance with the card issuer requirements. Accordingly, for the DAPI user group limits are just informative with no possibility to change them via API. DAPI users can only change individual card limits for a specific card up to the group limit's value or above it depending on the access rights assigned by DECTA. If the individual card limit's values have been set up for a specific card, then they will always work instead of group limit values.

Set of available card limits to manage:

  • ATM/POS cash withdrawal limits (amount and count);
  • Card present (POS) transaction limits (amount and count);
  • Card-not-present transaction limits (amount and count);
  • Card spending limits (in any device) (amount and count)
  • Single/ Daily / Monthly limits;
  • Contactless limit amount.

Any of the card limit endpoints require one of the following access rights:

  • with no restrictions - means that the user can set an individual limit's value up to or above group limit value;
  • with restrictions - means that the user isn’t allowed to set an individual limit's value above the group limit value.

To start using the endpoints, please contact your Account manager or Project manager.


Get limits reference data

If you want to receive information about available card limits with description make request GET/v1/api/limits. Any new card limit is introduced within DAPI release changes.


Get limits data by card

If you want to receive information about all card limits which are effective for the particular card you should use GET/v1/api/limits/{ppan}. This endpoint returns group limit values and individual limit values. If the individual limit value is not set, then the endpoint returns only group limit values.

Card limit change

If you want to set or change individual limits for the selected card, then you should use PATCH/v1/api/limits/{ppan}.

Important:

  • DAPI user can set only those individual limits that have values in group limits.
  • To delete individual limit value the object should be empty
  • In one request can be included changes of several individual limits
  • Card limits via API replaces CMS calendar limits with impossibility to use them anymore.
  • The limit value should be sent according to the corresponding limit, If limitation is for authorization count then value should be in minor units. If limitation is for authorization amount then value should be separated by dot delimiter according to the card currency.
  • Limits counts using original authorization amount converted into card account currency.
Jump to

  • Get limits reference data
  • Get limits data by card
  • Card limit change