API Reference

Demographic Data Fetch API

This API is used to retrieve the demographic details of the cardholder. The Credit+ Issuing system receives, validates and processesthe request. If the request is successful, the cardholder’s demographic details are returned in the response. If the request fails, the system returns the corresponding error code. **NOTE:

  1. The API, if sent with cardNumberAlias (CNA), will internally 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).
  2. Either deviceNumber or cardNumberAlias parameter’s value must be provided to process the request. However, if both are received in request then the system will not validate if the cardNumberAliasislinked to that particular device. System processesthe request based on the device number itself.**

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.
HTTPS CodeError CodesReason
201000Success
400-1No data found for device
400997Device Number and Card Number Alias fields are empty. At least one of the two values must be provided.
400997Device Number is of invalid format.
400997Product Type field is invalid.
400997Program Code field should only contain [A-Z 0-9] and underscore and must start and end with alphanumeric character.
400997Program Code field value must have max length 6.
400997Device Plan Code field should only contain [A-Z 0-9] and underscore and muststart and end with alphanumeric character.
400997Device Plan Code field value must have max length 10.
400997Only alphanumeric characters and special characters [_!'()*+,-.] are allowed.
400997Card Number Alias field value must have max length 24.
400-1Device number not registered in the system
Language
URL
Click Try It! to start a request and see the response here!