This API is used to change a credit card's credit and/or cash limit, as specified, through various channels such as online banking or mobile banking. The API can also be used to change the limits at wallet and client level.
The Credit+ Issuing system receives, validates and processes the request. If the request is successful, the card’s credit or cash limit is updated, system logs the “Credit Limit Change Request” (Service Code: 226) service request (SR) and sends the service request details in the response message. If the request fails, the system returns the corresponding error code in the response and the SR is not logged.
This API can be used to update the limits of the Add-On card as well. However, this API can’t be used for corporate cards. Card level limits can’t be greater than wallet’s and client’s respective limits. Similarly, wallet level limit can’t be greater than client’s level respective limit. s This API can used to define a new temporary credit limit. If the existing limit is defined and end date of limit is not crossed, you can define a new credit limit from the next business day. The existing request is obsoleted.
If no existing credit limits are defined, you can define a new credit limit from the current business day.
HTTP Status and Response Status Matrix
- HTTP Code: This is the response status code issued by a server in response to a client's request made to the server.
- Error Code: This is the error code returned by Credit+ Issuing application in the ‘code’ field of the response message indicating if the request was processed successfully or failed.
- Reason: This is the description of the error code returned by Credit+ Issuing application.
| HTTP Code | Error Code | Reason |
|---|---|---|
| 201 | HDS000 | Request processed successfully |
| 201 | CCRBO0004 | Request processed successfully |
| 400 | CLMT023 | Device number 1 and device number 2 cannot be same |
| 400 | CLMT021 | Device is not primary Device/Invalid Device. |
| 400 | CLMT022 | Error while fetching primary details |
| 400 | CLMT001 | Invalid supplementary/Add-on device |
| 400 | CLMT002 | Error while fetching details from device |
| 400 | CLMT020 | Device is not linked to primary device |
| 400 | CLMT007 | Error while fetching details for card balance |
| 400 | CLMT008 | Error while fetching details from card balance |
| 400 | CLMT010 | Invalid Client code |
| 400 | CLMT011 | Error while fetching details from client |
| 400 | CLMT003 | Invalid wallet number |
| 400 | CLMT004 | Error while fetching details from wallet |
| 400 | CLMT005 | Invalid client |
| 400 | CLMT006 | Error while fetching details from client |
| 400 | CLMT007 | Error while fetching details for card balance |
| 400 | CLMT008 | Error while fetching details from card balance |
| 400 | HDE050 | Institution code is mandatory |
| 400 | HDE051 | Device number is mandatory |
| 400 | HDE052 | Service code is mandatory. |
| 400 | HDE053 | Error in fetching data from service_code_mst |
| 400 | HDE054 | Active request Already exist |
| 400 | HDE523 | This Service Request is not allowed for Add on device |
| 400 | HDE524 | This Service Request is not allowed for closed device |
| 404 | 998 | Device(s) does not exist |
| 500 | 999 | Statement not available for last 3 months. |
| 400 | 997 | Month’s data is invalid |
| 403 | 900 | Invalid User |
| 400 | SERVIC001 | Service request is not applicable to product type. |
| 500 | MAIL004 | Invalid Device Number. |
| 400 | 997 | commodityUnitQuantity field field value must have max length 12. |
| 400 | 997 | Commodity Unit Quantity should be in pure Number. |
| 400 | 997 | Commodity Unit Price should be Number. |
| 400 | 997 | commodityUnitPrice field value must have max length 12. |
| 400 | CLMT025 | Temporary limit change is not allowed for Islamic credit card. |
| 400 | CLMT027 | Commodity type is required for cardholder level credit limit change request. |
| 400 | CLMT029 | Commodity unit price is required for cardholder level credit limit change request. |
| 400 | CLMT028 | Commodity unit quantity is required for cardholder level credit limit change request. |
| 400 | CLMT030 | Certificate number is required for cardholder level credit limit change request. |
| 400 | CLMT031 | Client decrease in credit limit is not expected for current request. |
| 400 | CLMT031 | Client cash limit is not expected for current request. |
| 400 | CLMT034 | Wallet credit limit is not expected for current request. |
| 400 | CLMT035 | Wallet cash limit is not expected for current request. |