UpdateCardStatus

To change the status of a card record, you can send a PUT request to the following endpoint:

PUT /api/Card/v{{version}}/Interswitch/UpdateCardStatus

The request body should contain the cardId of the card record, along with the new status to move it to, and an optional reason explaining the change.

This endpoint streamlines the process of managing a card's lifecycle, offering a single call to block, unblock, hotlist, or activate a card as needed.

This endpoint can be used for card activation, among other status changes.

Headers

Name	Value
Content-Type*	application/json
Request-Reference	unique_string

Body

Name	Data Type	Required	Description
cardId	string		Id of the card record.
status	string		Status to update the card to.
reason	string		Reason for updating the card status.

Here is an example request and response with a sample payload sent to the endpoint in Curl format.

Sample Request

curl --location -g --request PUT '{{baseUrl}}/api/Card/v{{version}}/Interswitch/UpdateCardStatus' \
--header 'Content-Type: application/json' \
--data '{
  "cardId": "5099f14c-b963-4919-95a4-104a42eeedd8",
  "status": 4, //Block = 1, Unblock = 2, Hotlist = 3, Activate = 4
  "reason": "Card Activation"
}'

Response: 200

{
  "status": true,
  "message": "Operation Successful"
}