API Reference

Add-On Card API

This API is used to request for add-on card applications through various channels such as, online banking or mobile banking, or any issuer’s applications. The Credit+ Issuing system receives, validates, and processesthe request. If the request is successful, the system logs the log only ‘Add-on Card Request’ (Service Code: 102) service request (SR). Based on the bank's decision, the bank user hasto raise the Add-on card SR, or add-on card application through customer portal screens to create the add-on card. The service request number is sent in the response message. If the request fails, the system returns the corresponding error code in the response and the SR is not logged. Once the system logs the Add-on Card service request (SR 102) and the escalation matrix (maker and checker) is configured for the SR, the service requestshall always be in Open Status. The service request is then not available in the checker queue for approval. Once the system logs the Add-on Card service request (SR 102) and the escalation matrix (maker and checker) is not configured for the SR, the service request shall be marked as resolved.

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
201HDE000Request processed successfully
201CCRBO0004Request processed successfully
400913Backward offset time limit violated.
400913Forward offset time limit violated.
400994Invalid Request - Unrecognized field.
400997Device Number field is mandatory
403900Device Number field should be numeric.
404998Invalid Priority Request
404988Encryption type Not Supported.
500999Invalid Request Type
400997Request Date field is mandatory
400997Request Date must be in MM-DD-YYYY HH:MM:SS format.
400997Title field is mandatory
400997First Name field should be alphanumeric and may contain space.
400997Last Name field is mandatory. First Name field is mandatory.
400997Last Name field should be alphanumeric and may contain space.
400997Embossed Name field is mandatory.
400997Embossed Name field should be alphanumeric and may contain space.
400997Embossed name should not contain any special characters other than spaces, periods and field length should be between 2-26
400997Relation field is mandatory.
400997First Name field is Birth Date must be in MM-DD-YYYY format.
400997Request Date should be less than or equal to institution date.
400997Birth Date should be less than institution date.
400997Alternate Name field value must have max length 200.
400997Embossing Line4 field should not contain any special characters otherthan spaces, periods, and field length should be between 2-26.
400997Registered Mobile Number field is mandatory.
400997Registered Mobile Number field should be numeric.
400997Registered Mobile Number field value must have max length 15.
400997ISD Code field is mandatory.
400997ISD Code field value must have max length 6.
400997Registered e-mail ID field is mandatory.
400997Registered e-mail ID field must be a valid email id.
400997Registered e-mail ID field value must have max length 50.
400997Preferred Language field is invalid.
400997Marital Status field is invalid.
400997Marital Status field is mandatory.
400997Country Code field is mandatory.
400997Country Code field value must have max length 3.
400997AddressLine1 field is mandatory.
400997AddressLine1 field value must have max length 150.
400997AddressLine1 field should only contain [a-z A-Z 0-9], SPACES and special characters [.,&#:*()-] and must start with an alphanumeric character.
400997AddressLine2 field value must have max length 150.
400997AddressLine2 field should only contain [a-z A-Z 0-9], SPACES and special characters [.,&#:*()-] and must start with an alphanumeric character.
400997AddressLine3 field value must have max length 150.
400997AddressLine3 field should only contain [a-z A-Z 0-9], SPACES and special characters [.,&#:*()-] and must start with an alphanumeric character.
400997AddressLine4 field value must have max length 150.
400997AddressLine4 field should only contain [a-z A-Z 0-9], SPACES and special characters [.,&#:*()-] and must start with an alphanumeric character.
400997Preferred Mailing Address field is invalid.
400997Preferred Mailing Address field is mandatory.
400997Credit Limit field must be a positive value with maximum 12 integers and 7 fractions.
400997Cash Limit field must be a positive value with maximum 12 integers and 7 fractions.
400997Credit Limit field is invalid.
400997Cash Limit field is invalid.
400997Preferred Mailing Address field is mandatory
400997Instant Card Flag field is invalid.
400998NO_DEVICE_ERROR
400AD102Invalid Title.
500AD103Error while getting title details
400AD104Invalid Relation
500AD105Error while getting Relation details
500AD107Error while getting Device Plan details.
400AD106Device Plan not present for given program attached to device
400AD108Invalid Picture code
500AD109Error while getting Picture code details
400AD110Invalid Gender code
500AD112Error while executing Add on Card replace through AP
400AD113Length of First name should be less than 100
400AD113Length of Last name should be less than 100.
400AD102Demographic Fetch issue.
400AD123Credit limit is lessthan the limit defined at the program.
400AD124Cash limit is more than the limit defined at the program.
400AD125Credit limit is mandatory if cash limit is given.
400AD126Cash limit must be equal to program fixed cash limit.
400AD127Cash limit must be greater than product minimum cash limit.
400AD128Cash limit must be less than product maximum cash limit.
400AD121Invalid Branch limit.
400AD130Credit/Cash limit for Prepaid/Debit card should be blank.
400AD133Invalid value - Zip Code
400AD201Client Code is not valid.
400AD228Invalid device type.
400APPOB0001Onboarding is not allowed on Device Plan: [Device plan code related to the device].
400PRC001Provided Credit limit is greater than Card Credit limit
400PRC002Provided Cash limit is greater than card cash limit
400PRC003Cash limit should be less than credit limit
400PRC004Insufficient branch level limit
400PRC100Error, Validation at cr card balance details
400HDE050Institution code is mandatory
400HDE051Device number is mandatory
400HDE052Service code is mandatory.
500HDE053Error in fetching data from service_code_mst
400HDE054Active request Already exist
400HDE523This Service Request is not allowed for Addon device
400HDE524This Service Request is not allowed for closed device
400SERVIC001Service request is not applicable to product type.
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!