Client Profile Update API

post https://uatmea-iss-apigw.creditpluspinelabs.com/deviceapi/apis/v1/services/client/profileUpdate

This API is used to update the cardholder demographic information in Pine Labs system. This API is applicable for prepaid, credit and debit products issued on Pine Labs platform.

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).

Why would I need to use this resource?

Third party can enabled the profile update service to cardholder using this API resource. Cardholder can update the demographics details using this API.

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	923	Registered email Id not present in the system.
400	924	Request cannot be processed considering current device status.
400	999	Institution date not found!
400	997	Request Date field must be in yyyyMMdd format.
400	997	Birth Date should be less than institution date.
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 Factorfield value must have min length 10.
400	997	Title field is mandatory.
400	997	First Name field is mandatory.
400	997	First Name field should be alphanumeric and may contain space.
400	997	First Name field value must have max length 100.
400	997	Middle Name1 field should be alphanumeric and may contain space.
400	997	Middle Name1 field value must have max length 100.
400	997	Middle Name2 field should be alphanumeric and may contain space.
400	997	Middle Name2 field value must have max length 100.
400	997	Last Name field is mandatory.
400	997	Last Name field should be alphanumeric and may contain space.
400	997	Last Name field value must have max length 100.
400	997	Marital Status field is mandatory.
400	997	Maiden Name field should be alphanumeric and may contain space.
400	997	Maiden Name field value must have max length 50.
400	997	Gender field is mandatory.
400	997	Birth Date field is mandatory.
400	997	Birth Country field value must have max length 3.
400	997	Nationality Code field value must have max length 3.
400	997	Embossed Name field value must have max length 26.
400	997	Permanent Address1 field is mandatory.
400	997	Permanent City field is mandatory.
400	997	Permanent Country field is mandatory.
400	997	Permanent Address1 field value must have max length 150.
400	997	Permanent Address2 field value must have max length 150.
400	997	Permanent Address3 field value must have max length 150.
400	997	Permanent Address4 field value must have max length 150.
400	997	Permanent City field value must have max length 5.
400	997	Permanent State field value must have max length 3.
400	997	Permanent Country field value must have max length 3.
400	997	Permanent ZIP Code field value must have max length 10.
400	997	Permanent Contact No1 field value must have max length 15.
400	997	Permanent Contact No2 field value must have max length 15.
400	997	Office Address1 field is mandatory.
400	997	Office City field is mandatory.
400	997	Office Country field is mandatory.
400	997	Office Address1 field value must have max length 150.
400	997	Office Address2 field value must have max length 150.
400	997	Office Address3 field value must have max length 150.
400	997	Office Address4 field value must have max length 150.
400	997	Office City field value must have max length 5.
400	997	Office State field value must have max length 3.
400	997	Office Country field value must have max length 3.
400	997	Office ZIP Code field value must have max length 10.
400	997	Office Contact No1 field value must have max length 15.
400	997	Office Contact No2 field value must have max length 15.
400	997	Office Ext field value must have max length 15.
400	997	Office Mobile ISDN field value must have max length 3.
400	997	Office Mobile Number field value must have max length 15.
400	997	Office Email Address field must be a valid email id.
400	997	Current Address1 field is mandatory.
400	997	Current Address1 field value must have max length 150.
400	997	Current Address2 field value must have max length 150.
400	997	Current Address3 field value must have max length 150.
400	997	Current Address4 field value must have max length 150.
400	997	Current City field value must have max length 5.
400	997	Current State field value must have max length 3.
400	997	Current Country field is mandatory.
400	997	Current Country field value must have max length 3.
400	997	Current ZIP Code field value must have max length 10.
400	997	Current Contact No1 field value must have max length 15.
400	997	Current Contact No2 field value must have max length 15.
400	997	Designation field should be numeric.
400	997	Joining Date field must be in ddMMyyyy format.
400	997	Employer Name field value must have max length 40.
400	997	Occupation Type field should be numeric.
400	997	Occupation Type field value must have size 1.
400	997	Employer Type field should be numeric.
400	997	Employer Type field value must have max length 20.
400	997	Employment Status field should be numeric.
400	997	Fax Number field value must have max length 15.
400	997	Register Mobile ISDN Code field value must have max length 15.
400	997	Registered Mobile Number field is mandatory.
400	997	Registered e-mail ID field is mandatory.
400	997	Registered Mobile Number field value must have max length 15.
400	997	Office Email ID field value must have max length 50.
400	997	Registered e-mail ID field must be a valid email id.
400	997	Statement Copy Mode field is invalid.
400	997	Legal Id Type1 field value must have max length 30.
400	997	Legal Id Type2 field value must have max length 30.
400	997	Legal Id Type3 field value must have max length 30.
400	997	Legal Id Type4 field value must have max length 30.
400	997	Legal Id Type1 & Legal Id Type2 are same.
400	997	Legal Id Type1 & Legal Id Type3 are same.
400	997	Legal Id Type1 & Legal Id Type4 are same.
400	997	Legal Id Type2 & Legal Id Type3 are same.
400	997	Legal Id Type2 & Legal Id Type4 are same.
400	997	Legal Id Type3 & Legal Id Type4 are same.
400	997	Legal Id1 field is mandatory.
400	997	Legal Id2 field is mandatory.
400	997	Legal Id3 field is mandatory.
400	997	Legal Id4 field is mandatory.
400	997	Legal Id1 field value must have max length 25.
400	997	Legal Id2 field value must have max length 25.
400	997	Legal Id3 field value must have max length 25.
400	997	Legal Id4 field value must have max length 25.
400	997	Legal Id Type field is empty.
400	997	Legal ID1 PlaceOfIssuance field value must have max length 15.
400	997	Legal ID2 PlaceOfIssuance field value must have max length 15.
400	997	Legal ID3 PlaceOfIssuance field value must have max length 15.
400	997	Legal ID4 PlaceOfIssuance field value must have max length 15.
400	997	Legal ID1 Expiry Date field must be in ddMMyyyy format.
400	997	Legal ID2 Expiry Date field must be in ddMMyyyy format.
400	997	Legal ID3 Expiry Date field must be in ddMMyyyy format.
400	997	Legal ID4 Expiry Date field must be in ddMMyyyy format.
400	997	Client Data Field1 field value must have max length 100.
400	997	Client Data Field2 field value must have max length 100.
400	997	Client Data Field3 field value must have max length 100.
400	997	Client Data Field4 field value must have max length 100.
400	997	Client Data Field5 field value must have max length 100.
400	997	Client Date Field1 field must be in yyyyMMdd format.
400	997	Client Date Field2 field must be in yyyyMMdd format.
400	997	Client Date Field3 field must be in yyyyMMdd format.
400	997	Client Date Field4 field must be in yyyyMMdd format.
400	997	Client Date Field5 field must be in yyyyMMdd format.
400	997	Client Amount Field1 field must be a positive value with maximum 9 integers and 2 fractions.
400	997	Client Amount Field2 field must be a positive value with maximum 9 integers and 2 fractions.
400	997	Client Amount Field3 field must be a positive value with maximum 9 integers and 2 fractions.
400	997	Client Amount Field4 field must be a positive value with maximum 9 integers and 2 fractions.
400	997	Client Amount Field5 field must be a positive value with maximum 9 integers and 2 fractions.
400	997	Email alert field is invalid.
400	997	SMS Alert field is invalid.
400	997	Phone Number1 field value must have max length 15.
400	997	Phone Number2 field value must have max length 15.
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	997	Product Type is Invalid.
400	997	Device Plan Code field should only contain [A-Z 0-9] and underscore and muststart and end with alphanumeric character.
400	997	Device Plan Code field value must have max length 10.
400	997	Program Code field value must have max length 10.
400	997	Program Code field should only contain [A-Z 0-9] and underscore and must start and end with alphanumeric character.
400	997	Residential Join Date field must be in ddMMyyyy format.
400	997	employmentStatusfield value must have max length 2.
400	998	Device is not normal.
400	922	Registered mobile number not present in the system.
400	APPUP00195	Length of Client Customer ID is invalid.
400	ORGUNIT01	For Multilevel Corporate - department field must be a valid organization unit/ Entity.
400	ORGUNIT02	For Multilevel Corporate - department field cannot be blank.
400	UPDPRF000	Successful
400	UPDPRF001	Invalid transaction code
400	UPDPRF002	Invalid Title
400	UPDPRF003	Invalid Occupation Type
400	UPDPRF004	Invalid Legal id type
400	UPDPRF005	Invalid Legal id type
400	UPDPRF006	Invalid Legal id type
400	UPDPRF007	Invalid Legal id
400	UPDPRF008	Legal id type/Legal id can not be null
400	UPDPRF009	Legal id type/Legal id can not be null
400	UPDPRF010	Legal id type/Legal id can not be null
400	UPDPRF011	Legal id type/Legal id can not be null
400	UPDPRF012	Legal Id type 1 is Matched with another Legal Id types.
400	UPDPRF013	Legal Id type 2 is Matched with another Legal Id types.
400	UPDPRF014	Legal Id type 3 is Matched with another Legal Id types.
400	UPDPRF015	Legal Id 1 is Matched with another Legal Id''s.
400	UPDPRF016	Legal Id 2 is Matched with another Legal Id''s.
400	UPDPRF017	Legal Id 3 is Matched with another Legal Id''s.
400	UPDPRF018	Invalid Marital status
400	UPDPRF019	Invalid nationality
400	UPDPRF020	Invalid Gender
400	UPDPRF021	Invalid Birth date
400	UPDPRF022	Invalid Birth Country
400	UPDPRF023	Invalid Preferred Mailing Address
400	UPDPRF024	Invalid client
400	UPDPRF025	For Current preferred mailing address, Current address/Country / State /City /Zip Code is mandatory
400	UPDPRF026	Invalid Pin code
400	UPDPRF027	Invalid client
400	UPDPRF028	For Permanent preferred mailing address, Permanent address/ Country /State /City /Zip Code is mandatory
400	UPDPRF030	Invalid client
400	UPDPRF031	For Office preferred mailing address, Office address/Country / State /City /Zip Code is mandatory
400	PRFLNG001	Invalid Language Code
400	UPDPRF039	Error while updating the client
400	UPDPRF040	Error while updating the client
400	UPDPRF041	Invalid client
400	UPDPRF042	Error while updating the client
400	UPDPRF043	Error while selecting product type
400	UPDPRF043	Error while updating the client.
400	UPDPRF044	Device not found
400	UPDPRF045	Failed to fetch Product type
201	LEGAL000	Success.
400	CNA001	Bank Does Not Exists.
400	CNA002	Card Number Alias Functionality is not applicable forthis Institution.
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	997	Only alphanumeric characters and underscore are allowed.
500	913	Backward offset time limit violated.
500	999	Internal error
400	994	Invalid Request - Unrecognized field.
400	988	Encryption type Not Supported.
400	913	Forward offset time limit violated.
400	UPDPRF147	Client not registered yet.
400	UPDPRF125	For Current preferred mailing address Country Code is mandatory.
400	UPDPRF120	For Current preferred mailing address Current address 1 is mandatory.
400	UPDPRF128	For Permanent preferred mailing address Country Code is mandatory.
400	UPDPRF121	For Permanent preferred mailing address Permanent address 1 is mandatory.
400	UPDPRF131	For Office preferred mailing address Country Code is mandatory.
400	UPDPRF122	For Office preferred mailing address Office address 1 is mandatory.
400	UPDPRF130	Invalid Joining Date/ Format.
400	UPDPRF134	Invalid Residential Joining Date/ Format.
400	994	Invalid Encryption-Algorithm header value
400	994	Invalid Encryption Request Parameters
400	994	Cryptography error