Set card limits

This method sets card limits based on the preferences of the bank, account owner or cardholder. Modification of card limits is permissible only for cards that are in an "ACTIVE" state and are associated with "ACTIVE" accounts. The adjustment of card limits is determined by user roles originally assigned to the card limits:

• If the record is requested by "BANK," only "BANK" has permission to modify it.
• If the record is requested by "ACCOUNT OWNER," both "BANK" and "ACCOUNT OWNER" have the permission to make modifications.
• If the record is requested by "HOLDER," all user roles have permission to make modifications.

To set a limit for a card, the ID of the limit must be provided along with all the necessary values. All limits included in CPD, which allows modifications must be included in a request for a new card. If a limit has a range of values set by CPD, the CMS will allow only setting limit value in this range. Limits can be configured for daily, weekly, and monthly periods, encompassing both amount and count settings. List of limits can be found here.

URL test:

https://dev.lightcms.io/cms/v1/cards/{id}/limits

URL live:

https://fat.lightcms.io/cms/v1/cards/{id}/limits

Method:

PUT

Path items:

/cards (Card Service)

/{id} (ID code of limit)

/limits (Method name)

Parameters:

Parameter	Location	Type	Example	Description	Required
ID	Path	"string"	"108564234"	Internal ID of Card	Yes
limitInfo	Path	"object"	-	Limits detials	Yes
limitId	limitInfo	"string"	LIM_POS_D	Limit ID specified in CPD	Yes
name	limitInfo	"string"	"POS DAILY LIMIT"	Limit name	No
limitValue	limitInfo	"integer"	"50000"		Yes
limitType	limitInfo	"string"	"AMOUNT"	AMOUNT/COUNT Limit type	No
requestedBy	Body	"string"	"BANK"	Level of user role	Yes

Example:

curl -X 'PUT' \
  'https://dev.lightcms.io/cms/v1/cards/9/limits' \
  -H 'accept: */*' \
  -H 'Content-Type: application/json' \
  -d '{
  "limitInfo": [
    {
      "limitId":"LIM_17_ECOM_AMT_D",
      "limitType":"AMOUNT",
      "limitValue": 12345,
      "name": "E-commerce transactions"
    }
  ],
  "requestedBy": "BANK"
}
'

Responses:

200 - OK

Status Code: 200 OK

404 - Not found

Status Code: 404 Not found

{
"errorMessage": "Entity with id 132132123 not found in DB."
}

Parameter	Location	Type	Example	Description
errorMessage	body	string	"Entity with id 132132123 not found in DB."	Error message

500 - Internal Server Error

Status Code: 500 Internal Server Error

{
"timestamp": "2024-04-10T12:39:13.058+00:00",
"status": 500,
"error": "Internal Server Error",
"path": "/cms/v1/cards/18/limits"
}

Parameter	Location	Type	Example	Description
timestamp	body	date	"2024-04-10T12:39:13.058+00:00"	Timestamp of request
status	body	integer	500	Status error code
error	body	string	"Internal Server Error"	Error description
path	body	string	"/cms/v1/cards/18/limits"	Request path