post https://uatmea-iss-apigw.creditpluspinelabs.com/deviceapi/apis/v1/services/cardholder/otcreplacement
Credit+ Issuing system will receive the OTC (Over the Counter) device replacement API request call and respond back with the OTC device replacement API response. For Successful response, the new device number will be replaced with the old device. This Request is applicable only for Prepaid/ Debit products. Replacement should be allowed even if the card status is Lost, Stolen or blocked. This API will not be applicable for LVC (Limited Validity Card) and SVC (Static Virtual Card).
NOTE:
The API, if sent with Card Number Alias (CNA), will fetch the corresponding associated device for further processing only if DEVICE _STATUS_CODE = LOST (05), or STOLEN (06), or BLOCK (14) or 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 | Description |
|---|---|---|
| 201 | 000 | Successful |
| 400 | 151 | Failed due to internal error. Please contact system admin. |
| 400 | 169 | Card Pack ID is mandatory for OTC replacement. |
| 400 | 400 | OTC Device Replacement failed: invalid request |
| 400 | 404 | Device(s) does not exist |
| 400 | 417 | Error while getting plan details |
| 500 | 500 | Invalid Request Type |
| 400 | 997 | Form Factor Type is mandatory |
| 400 | 997 | Form Factor Type should be CRD or CPI |
| 400 | 997 | Form Factor field is mandatory |
| 400 | 997 | Device Number in Form Factor field is mandatory |
| 400 | 997 | Card Pack ID in Form Factor field is mandatory |
| 400 | 997 | Device Number is of invalid format |
| 400 | 997 | Replacement reason is mandatory |
| 400 | 997 | New card pack ID is mandatory |
| 400 | 997 | Replacement fee indicator should be 0 or 1 |
| 400 | 170 | Request not allowed for this device type |
| 400 | 150 | Device Status should be in Lost or Stolen or Blocked for OTC replacement |
| 400 | GETDEV001 | Invalid Device |
| 400 | GETDEV002 | Invalid Card Pack ID |
| 400 | GETDEV003 | Invalid Client Code |
| 400 | GETDEV004 | Error while facing device number |
| 400 | HDE181 | Device Status should be in Lost or Stolen or Blocked for OTC replacement |
| 400 | OTC041 | This pack cannot be sold from agent portal |
| 400 | OTC100 | Device Status and replace reason should be same |
| 400 | OTC051 | Instant Device Replacement is not allowed for this device plan |
| 400 | OTC003 | OTC is not allowed as new card pack id is of different program or product |
| 400 | OTC006 | New card number is already sold and delivered |
| 400 | OTC015 | Pack ID can be sold only from agent portal |
| 400 | OTC117 | Primary Device Exists. Please stop list the device |
| 400 | OTC118 | Error while getting device plan details |
| 400 | OTC002 | Replacement is not allowed on limited virtual validity device |
| 400 | OTC011 | Expired Device |
| 400 | OTC008 | Replaced Device |
| 400 | OTC009 | Cancelled Device |
| 400 | OTC021 | Device In Production |
| 400 | OTC017 | Paired device present. Use Activate Paired Device service request to activate the paired device |
| 400 | OTC145 | Device is already replaced, or its pair card is already activated |
| 400 | OTC146 | Replacement not allowed for this device because Paired card of this device is already replaced |
| 400 | 997 | Program Code field should only contain [A-Z 0-9] and underscore and must start and end with alphanumeric character. |
| 400 | 997 | Device Plan Code field should only contain [A-Z 0-9] and underscore and must start and end with alphanumeric character. |
| 400 | 997 | Product Type field is invalid. |
| 400 | 997 | Only alphanumeric characters and underscore are allowed. |
| 400 | 997 | FORM_FACTOR field value must have max length 24. |
| 400 | CNA006 | Multiple device numbers are active for given details |
| 400 | CNA002 | Card Number Alias Functionality is not applicable for this Institution |
| 400 | CNA003 | Record does not exist for the given details |
| 400 | CNA001 | Bank Does Not Exists |
| 400 | APPUP00105 | Branch code does not exist. |
| 400 | BRCHCD001 | Invalid Branch Code. |