Set Cardholder Level Limit – Function CardLimit
Sets a limit at the Cardholder level which would supersede the Issuer, Program or Account configured limit. This allows for most of a limit to be set through the API. Note that the limit and count configuration must not exceed the limit values for the issuer, programme, or account level configured limit. The limit being set must have a parent counterpart for the same period e.g., Daily, Monthly, etc. The risk level is set to zero for these cardholder level limits. The limits that are currently adjustable are as follows.
• Total POS – [limit_total_pos]
• Total Cash – [limit_total_cash]
The values that can be set for the above are as follows.
• Limit Count – Transaction count within the limit Period
• Limit Amount – Transactions total amount within the limit Period
• Limit Period – Limit time period
The query parameters are as follows.
| Inputs | Description | Required | Data Type |
|---|---|---|---|
| FUNC | CardLimit | Y | |
| P1 | PAN or ALT ID | Y | (12…24) Alphanumeric |
| P2 | Limit Name (POS or CASH) | Y | (1…24) Alphanumeric |
| P3 | Limit Count | Y | (1…99999) Number |
| P4 | Limit Amount | Y | (1…999999999) Number |
| P5 | Limit Period (D, L, M, C, Y, W) | Y | (1) Alpha |
| P6 | Remove the configured cardholder level limit | N | (DELETE) Alpha |
| Output | Description | ||
| P1 | Error/Response Code | ||
| P2 | Error/Response Text |
P1=0000&P2=Limit limit_total_pos set with count 200 and amount 1000 for period D
P1=5901&P2=Set Card Level Limit Error: No card number found
P1=5901&P2=Set Card Level Limit Error: Requested Count or Amount cannot be greater than the program
configuration
P1=5999&P2=System Errors…
has not been setup on the issuer/program yet. To allow the SetCondCheck
Fuction to work, a request to change the issuer/program level limit would be
required.