BlockUnblockCard

The "BlockUnblockCard" endpoint allows customers to change a card's status between blocked and unblocked, useful for temporarily restricting a card (e.g. if reported lost) or restoring it to active use.

PUT /api/Card/v{{version}}/Providus/BlockUnblockCard

To update a card's status, provide the cardId of the card along with the status to set it to 1 to block the card, 2 to unblock it.

Headers

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

Body

Name	Data Type	Required/Optional	Description
cardId	string		The cardId field from the SearchCards endpoint response.
status	Enum (Block = 1, Unblock = 2)		The status to set the card to.

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}}/Providus/SetCardPIN' \
--header 'Content-Type: application/json' \
--data '{
  //"cardRecordId": "b6adc86a-750d-436a-9625-b35400c5ed58" //Id field in the SearchCards endpoint response
  "cardId":"76b0c321-9376-4bde-b4e6-f4740189ed40", //cardId field in the SearchCards endpoint response
  "status": 1 //Block = 1, Unblock = 2
}'

Response: 200

{
  "status": true,
  "message": "Request successful",
  "data": {
    "responseCode": "00",
    "responseMessage": "Card successfully blocked"
  }
}