post https://uatmea-iss-apigw.creditpluspinelabs.com/deviceapi/apis/v1/services/helpdesk/cardreplacement
The request for Card Replacement Request API is received from a third-party channel (netbanking/mobile banking). The system will first validate and then processthe request. Once the validations are passed, the system creates a ‘Replace/Upgrade Device Request’ service request and sends the service request details in the response message. NOTE: This API, if sent with Card Number Alias (CNA), will fetch the corresponding associated device for further processing only if DEVICE _STATUS_CODE = NORMAL (0) or DEVICE _STATUS_CODE = EXPIRED (12).
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. |
| 400 | 997 | Device Number field is mandatory. |
| 400 | 997 | Device Number field should be numeric. |
| 400 | 997 | Priority Request field is invalid. |
| 400 | 997 | Request Date field is mandatory. |
| 400 | 997 | Request Date field must be in MM/dd/yyyy HH:mm:ss format. |
| 400 | 997 | Reason field is mandatory. |
| 400 | 997 | New Card Number field value must be '1' |
| 400 | 997 | New Card Number field value must be '0' |
| 400 | 997 | New Card Number field is mandatory. |
| 400 | 997 | New Card Number field is invalid. |
| 400 | 997 | Replacement Fees field is mandatory. |
| 400 | 997 | Replacement Fees field is invalid. |
| 500 | 999 | Internal error. |
| 400 | 997 | Request Date should be less than or equal to institution date. |
| 400 | CR200 | Invalid reason Code. |
| 400 | CR207 | Invalid Device number. |
| 400 | CR209 | Device plan not found for configured replacement device technology. |
| 400 | CR210 | Existing device plan and new device plan are same for reason code. |
| 400 | CR211 | Replacement Device Technology is not configured for this device plan. |
| 400 | 100 | Bank is not specified. |
| 400 | 102 | Device number does not exist. |
| 400 | 104 | Device belongs to different Product. |
| 400 | 135 | Replacement is not allowed as Device is not sold |
| 400 | 190 | Replacement is not allowed on limited virtual validity device. |
| 400 | 136 | Replaced Device. |
| 400 | 106 | Inactive DEVICE. |
| 400 | 107 | Cancelled DEVICE. |
| 400 | 109 | Device In Production. |
| 400 | 139 | Paired device present. Please use Activate Paired Device service request to activate the paired device. |
| 400 | 145 | Device is already replaced, or its pair card is already activated. |
| 400 | 146 | Replacement not allowed for this device because Paired card of this device is already replaced. |
| 400 | 998 | Invalid device number. |
| 400 | STPLST006 | Invalid reason code. |
| 400 | HDE120 | Withdrawal Denied due to sticky reason code. |
| 500 | 913 | Backward offset time limit violated. |
| 400 | 994 | Invalid Request - Unrecognized field. |
| 400 | 988 | Encryption type Not Supported. |
| 400 | 913 | Forward offset time limit violated. |
| 400 | APPUP00315 | Embossed Name must be an alphanumeric value, may contain spaces or periods and field length should be between 2-26. |
| 400 | APPUP00299 | Add-On Embossed name should not contain any special characters other than spaces, periods and field length should be between 2-26. |
| 400 | BRCHCD001 | Invalid Branch Code. |
| 400 | APPUP00105 | Branch code does not exist. |
| 400 | 994 | Invalid Encryption-Algorithm header value |
| 400 | 994 | Invalid Encryption Request Parameters |
| 400 | 994 | Cryptography error |
| 400 | 997 | Numberless Card field is invalid |