post
https://uatmea-iss-apigw.creditpluspinelabs.com/deviceapi/apis/v1/services/cardholder/blockUnblock
This API can be configured to work in two modes- Block the Device and Unblock the Device. If a cardholder wants to block the device, a request (such as SMS) is raised, and the card is blocked. If the cardholder wants to unblock the device, a request is raised, and the card is unblocked. NOTE:
- For block request: The 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 = UPGRADE (9) AND UPGRADE_STATUS = 1).
- For unblock request: The API, if sent with Card Number Alias (CNA), will fetch the corresponding associated device for further processing only if DEVICE _STATUS_CODE = BLOCK (14). The following service codes will be logged based on status parameter: For Unblock Operation: 116, For Block Operation : 111
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 | BKWL000 | Request processed successfully [Application Code: BKWL000] |
| 403 | 900 | Invalid User |
| 404 | 998 | Device(s) does not exist |
| 500 | 999 | Internal error |
| 400 | 997 | Form Factor Type field is mandatory. |
| 400 | 997 | Form Factor Type field is invalid |
| 400 | 997 | Form Factor field is mandatory |
| 400 | 997 | Form Factor field value must have max length 24 |
| 400 | 997 | Form Factor field value must have min length 10 |
| 400 | 997 | Status field is mandatory |
| 400 | 997 | Status field is invalid |
| 400 | VALFRM003 | Invalid Device |
| 400 | VALFRM004 | Invalid Device |
| 400 | VALFRM024 | Device is not stoplisted |
| 400 | VALFRM026 | Error while getting device details |
| 400 | VALFRM027 | DB INTERNAL ERROR |
| 400 | VALFRM005 | Invalid Card Pack Id |
| 400 | VALFRM006 | Invalid Client |
| 400 | VALFRM007 | Invalid form factor type |
| 400 | VALFRM008 | Device status is not normal |
| 400 | VALFRM101 | Device is invalid for sale |
| 400 | VALFRM009 | Device status is not normal |
| 400 | VALFRM010 | Device is not block |
| 400 | VALFRM011 | Device is not normal |
| 400 | VALFRM012 | Device is not normal |
| 400 | VALFRM013 | Device is not normal |
| 400 | VALFRM014 | Device is not normal |
| 400 | VALFRM015 | Invalid device |
| 400 | VALFRM055 | Error getting device |
| 400 | VALFRM016 | Invalid device plan |
| 400 | VALFRM056 | Error getting device plan |
| 400 | VALFRM017 | Not allowed for Static Virtual Card/Limited Validity Virtual Card |
| 400 | VALFRM018 | Device is already delivered. Please use another pack id |
| 400 | VALFRM019 | Bin of device(s) for entered card pack id is stoplisted |
| 400 | VALFRM020 | Range of device(s) for entered card pack id is stoplisted |
| 400 | VALFRM021 | Device(s) for entered card pack id is stoplisted |
| 400 | VALFRM022 | Country is stoplisted |
| 400 | VALFRM028 | Invalid Device Number |
| 400 | VALFRM029 | Invalid device plan |
| 400 | VALFRM040 | Not allowed for Virtual Cards |
| 400 | VALFRM030 | Device is already Activated |
| 400 | VALFRM031 | Device is Cancelled |
| 400 | VALFRM032 | Device is Replaced |
| 400 | VALFRM034 | Device is Expired |
| 400 | VALFRM038 | Device is stoplisted |
| 400 | VALFRM033 | Device is not Normal |
| 400 | VALFRM035 | Device is not Delivered |
| 400 | VALFRM036 | Device is not Registered |
| 400 | VALFRM039 | Device cannot be activated as activation mode is not configured as Manual. |
| 400 | VALFRM045 | Device not Found |
| 400 | VALFRM046 | Error getting device information |
| 400 | VALFRM046 | Invalid Product type |
| 400 | VALFRM023 | Error while validating form factor |
| 400 | BLKDEV002 | Invalid Card Pack Id |
| 400 | BLKDEV003 | Error getting Card Pack Id |
| 400 | BLKDEV004 | Invalid Form Factor |
| 400 | BLKDEV005 | Error getting Form Factor details |
| 400 | BLKDEV005 | Internal error occurred during record fetching from Device |
| 400 | BLKDEV006 | Internal error occurred during record fetching from Program |
| 400 | BLKDEV007 | Device is already blocked |
| 400 | BLKDEV012 | Internal error occurred |
| 400 | BLKDEV009 | Device is not in normal state |
| 400 | BLKDEV011 | Error while processing request |
| 400 | BLKDEV014 | Internal error occurred during record fetching from Program |
| 400 | BLKDEV015 | Device is already active |
| 400 | BLKDEV017 | Internal error occurred |
| 400 | BLKDEV018 | Device is not in normal state |
| 400 | BLKDEV020 | Non_fungible_limits insert SCR error. Limits validation failed |
| 400 | CCNF0102 | Non_fungible_limits insert SCR error. Limits validation failed |
| 400 | CCNF0103 | Non_fungible_limits insert SCR error. Limits validation failed |
| 400 | CCNF0104 | Non_fungible_limits insert SCR error. Limits validation failed |
| 400 | CCNF0105 | Non_fungible_limits insert SCR error. Limits validation failed |
| 400 | CCNF0106 | Non_fungible_limits insert SCR error. Limits validation failed |
| 400 | STPLST037 | Can Not Insert Into SERVICE_DETAILS For DEVICE Number |
| 400 | STPLST038 | Can Not Insert Into SERVICE_DETAILS For DEVICE Number |
| 400 | STPLST039 | Can Not Insert Into SERVICE_DETAILS For DEVICE Number |
| 400 | CDUSG001 | Already active service request present for ATM within specified date range. Please choose different channel or dates. |
| 400 | CDUSG002 | Already active service request present for E-Com within specified date range. Please choose different channel or dates |
| 400 | CDUSG004 | Internal Error. Please check Batch Trace |
| 400 | CDUSG005 | Error while inserting into SERVICE_DETAILS For DEVICE Number |
| 400 | STPLST040 | Can Not Insert Into SERVICE_DETAILS For DEVICE Number |
| 400 | SQLCODE | Can Not Insert Into SERVICE_DTL_ESTIMATED_CLS For DEVICE Number |
| 400 | SQLCODE | Can Not update INSTANT_REWARD_SMS For DEVICE Number |
| 400 | HDE001 | Internal Error |
| 400 | CNA003 | Record does not exist for the given details |
| 400 | CNA005 | Multiple device numbers are active for given details |
| 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 | 994 | Invalid Encryption-Algorithm header value |
| 400 | 994 | Invalid Encryption Request Parameters |
| 400 | 994 | Cryptography error |