API Reference

Client Profile Information API (V2)

This API receivesthe client profile information from Pine Labssystem. It works for all device statuses.

It is applicable for prepaid, credit and debit products issued on Pine Labs platform.

NOTE: This API is used for the same purposes as ‘Client Profile Information API (V1)’. However, this API is encrypted and has additional request and response attributes. Further this 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 be enabled for profile information service to the cardholder using this API resource. Cardholder can see the wallet and device details along with 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 CodeError CodeReason
200000Successful
404997FORM_FACTOR field is mandatory.
404997FORM_FACTOR_TYPE field is mandatory.
404998Invalid Client.
404997FORM_FACTOR_TYPE field value must have max length 3.
404997FORM_FACTOR field value must have max length 24.
403900Invalid User.
404998Device(s) does not exist.
404998Invalid Device.
201318Error while retrieving data from Wallet Detail.
201318Error while retrieving data from Device Detail.
201318Error while retrieving data from Client Detail.
201GETCNT001Invalid device.
201GETCNT002Invalid Card pack ID.
201GETCNT004Error while retrieving client.
201GETCNT003Invalid client code.
201VALPRA001Error while validating primary/add on client.
500999Internal server error.
400997Form Factor field is mandatory
400997FormFactorType field is invalid.
400997Form Factor Type is mandatory
400997Program Code field should only contain [A-Z 0-9] and underscore and must start and end with alphanumeric character.
400997Device Plan Code field should only contain [A-Z 0-9] and underscore and must start and end with alphanumeric character.
400997Product Type field is invalid.
400997Only alphanumeric characters and underscore are allowed.
400997FORM_FACTOR field value must have max length 24.
400997FORM_FACTOR_TYPE field is invalid.
400VALILD001Invalid LID.
400VALILD002Multiple clients found for this legal ID.
400CNA006Multiple device numbers are active for given details
400CNA002Card Number Alias Functionality is not applicable forthisInstitution
400CNA003Record does not exist for the given details
400CNA001Bank Does Not Exists
400994Invalid Encryption-Algorithm header value
400994Invalid Encryption Request Parameters
400994Cryptography error
Language
URL
Click Try It! to start a request and see the response here!