post
https://uatmea-iss-apigw.creditpluspinelabs.com/deviceapi/apis/v1/services/client/kycUpdate
This API is used to update cardholder’s KYC details in the Pine Labs system. It is applicable for prepaid, credit and debit products issued on the Pine Labs platform. The KYC verification is allowed if it is enabled for the respective client, otherwise the request is declined. The request is also declined if the client registration is not complete, or the client is already KYC compliant.
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 |
|---|---|---|
| 201 | 000 | Request processed successfully. |
| 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 | Card Number is of invalid format. |
| 400 | 997 | Device Number and Card Numer Alias fields are empty. Please provide value for at least one field. |
| 400 | 997 | Multiple device numbers are active for given details. |
| 400 | 997 | Card Number Alias field value must have max length 24. |
| 400 | 997 | Product Type field is invalid. |
| 400 | 997 | Program Code field should only contain [A-Z 0-9] and underscore and must start and end with alphanumeric character. |
| 500 | 999 | Internal error. |
| 400 | 997 | Form Factor Type field is mandatory. |
| 400 | 997 | Form Factor field is mandatory. |
| 400 | 997 | Verification Status field is mandatory. |
| 400 | 997 | Form Factor field value must have max length 24. |
| 400 | 997 | clientCustomerID field value must have max length 20. |
| 400 | 997 | clientCustomerID field should be alphanumeric. |
| 400 | 997 | Client Customer ID field must be null for existing client. |
| 400 | APPUP00195 | Length of Client Customer ID is invalid. |
| 400 | KYCUPD000 | Successful. |
| 400 | KYCUPD008 | invalid device. |
| 400 | KYCUPD009 | This Service request is not allowed on this device since Device is not sold. |
| 400 | KYCUPD010 | Client is not registered. |
| 400 | KYCUPD005 | Invalid Verification Status. |
| 400 | KYCUPD006 | KYC already done for this client. |
| 500 | 105 | Error while kyc updation. |
| 400 | GETCNT001 | Invalid device. |
| 400 | GETDEV002 | Invalid Card pack id (for Form Factor Type Card Park id). |
| 400 | CNA003 | Record does not exist for the given details. |
| 400 | CNA005 | Multiple device numbers are linked for given details. |
| 400 | CNA006 | Error while fetching device details. |
| 400 | VALPAS002 | Not valid Acquirer id. |
| 400 | VALPAS003 | Acquirer is not active. |
| 400 | VALPAS004 | Incorrect Password. |
| 400 | VALFRM004 | Invalid Device. |
| 400 | VALFRM024 | Device is not stoplisted. |
| 400 | VALFRM026 | Error while getting device details. |
| 400 | VALFRM005 | Invalid Card Pack Id. |
| 400 | VALFRM006 | Invalid Client. |
| 400 | VALFRM007 | Invalid form factor type. |
| 400 | VALPAS003 | Acquirer is not active. |
| 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. |