API Reference

Card Activation

Credit + Issuing system will receive the Card Activation API request call and responds back with the Card Activation API response. If the response issuccessful, then device number/ Pack ID given in request will be activated. Else, appropriate message will be displayed. For this API, Device plan Activation mode will be “MANUAL”. For any other mode the activation request will be rejected. For this API, If in Device plan “PIN Data Transmission” is set as “PIN Via SMS” and “Card Activation - API” is selected in “PIN via SMS triggering events”, then clear PIN will be sent to cardholder on registered mobile number after successful card activation. If the system is not able to send the clear PIN due to an internal error, then original card activation request will not have any impact. Card Activation API will be applicable for personalized/non-personalized devices. In case of paired cards, only Primary Device will be activated. This API will not activate Paired Device.

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 CodeError CodeDescription
400400Request Parameters Validation Failure: Invalid Request
201404Device(s) does not exist
201500Request processing error
201VALFRM028Invalid Device Number
201VALFRM029Invalid Device Plan
201VALFRM040Not allowed for Virtual Cards
201VALFRM030Device is already Activated
201VALFRM031Device is Cancelled
201VALFRM032Device is Replaced
201VALFRM034Device is Expired
201VALFRM037Error while accessing stoplist data
201VALFRM038Device is stoplisted
201VALFRM033Device is not Normal
201VALFRM035Device is not Delivered
201VALFRM036Device is not Registered
201VALFRM039Device cannot be activated as activation mode is not configured as manual.
201ACTDEV004Invalid Card Pack ID
201ACTDEV005Invalid Device Number
201ACTDEV006Invalid Program
201ACTDEV001Invalid Transaction Code
201ACTDEV003Failed when updating device
201ACTDEV002Log statement request is failed due to internal error. Please contact system admin.
201VALFRM003Invalid Device
201VALFRM005Invalid Card Pack ID
201VALFRM007Invalid form factor type
400997Only alphanumeric characters and underscore are allowed
400997Form Factor field value must have min length 10.
400997Form Factor field value must have max length 24
400997Device Plan Code field value must have max length 10.
400997Device Plan 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 10.
400997Program Code field should only contain [A-Z 0-9] and underscore and must start and end with alphanumeric character.
400997Product Type field is invalid.
400CNA001Bank Does Not Exists
400CNA002Card number Alias functionality is not applicable for this institution.
400CNA003Record does not exist for the given details
400CNA005Multiple device number are active for given details
400CNA006Error while fetching device details.
500913Backward offset time limit violated.
400994Invalid Request - Unrecognized field.
400988Encryption type Not Supported.
400913Forward offset time limit violated.
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!