Update Card Status

Update Card Status API is used to block or unblock the card. The cardholder must send the last 4 digits of the card number and either the mobile number or account number in the request. This API can be configured to work in two modes: ‘Block the Device’ and ‘Block or Unblock a Device’. If a cardholder wantsto block the device, a request israised and the card is blocked. If the cardholder wants to unblock the device, a request israised and the card is unblocked. For Apple Pay, if the status of a card or a wallet is updated, then the system automatically updates the status of the token.

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
400994Either Mobile Number or Account Number is not specified.
401900User is not authenticated
404998No card(s) found for the request.
500995Multiple cards found for card number.
400994Product Type should be either C, P or D
400998Card not found
400994Last 4 digits of card number should be specified
400994Card Number is not specified
400994Mobile Number is not specified
400994Unblock request not allowed for Institution
500999Error while fetching Customization Checklist configuration
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
Headers
string
^[a-zA-Z0-9-]{1,50}$

API Consumer must share a Correlation-ID in the HTTP header for API requests. The Correlation-ID must be unique for each request. It is recommended to generate universally unique identifier (UUID) of length 32 or 36 that is compliant with RFC 4122. The maximum supported length is 50 alphanumeric characters. For example, ac97d177-9345-4934-8343-0f91a7a02836. If the Correlation-ID is not received in the incoming request, the system generates the UUID dynamically and assigns it to the request.

string

API Consumer can share Source in the HTTP header for API requests. For the list of Source values, see the Pre-conditions for HTTP Header of REST API topic in the Pre-requisite for Rest API section.

Response

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json