post
https://uatmea-iss-apigw.creditpluspinelabs.com/deviceapi/apis/v1/services/pin/authorizepinset
PIN Authorization API should not be initiated by consumer in case PIN Authentication API failed. Pine Labs also maintains the time difference between these two correlated APIs. It is expected latency of 180 Seconds/ 3 minutes between these two API’s in Production environment. In case PIN Authorization API is not received in 180 Seconds after successful response of API Authentication API, PIN Authorization API will be rejected with Proper Error message.
NOTE: 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).
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 |
|---|---|---|
| 200 | 000 | Successful. |
| 400 | 911 | Mandatory field validation failed. |
| 408 | 912 | Forward Offset Time limit Violated. |
| 408 | 913 | Backward Offset Time limit Violated. |
| 408 | 915 | Pin set operation time limit violated. |
| 404 | 916 | Incorrect API Reference Number or Device Number. |
| 500 | 917 | Failed to Set PIN. |
| 500 | 999 | Error while processing request. |
| 400 | 997 | Program code field should only contain [A-Z 0-9] and underscore and must start and end with alphanumeric character |
| 400 | 997 | Program Code field value must have max length 6. |
| 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 | Device Plan Code field value must have max length 10. |
| 400 | 997 | Only alphanumeric characters and underscore are allowed. |
| 400 | 997 | Card Number Alias field value must have max length 24. |
| 400 | 997 | Product Type field is invalid. |
| 400 | 997 | Device Number and Card Number Alias fields are empty. Please provide value for atleast one field. |
| 400 | CNA001 | Bank Does Not Exists |
| 400 | CNA002 | Card Number Alias Functionality is not applicable forthisInstitution |
| 400 | CNA003 | Record does not exists for the given details |
| 400 | CNA005 | Multiple device numbers are active for given details |
| 400 | CNA006 | Error while fetching device details |
| 400 | 994 | Invalid Encryption-Algorithm header value |
| 400 | 994 | Invalid Encryption Request Parameters |
| 400 | 994 | Cryptography error |