Block Card

Endpoint

PUT/api/v1/merchant/cards/{cardId}/block/

Use this endpoint to block card usage.

This endpoint allows clients to block a card for risk and compliance reasons. When a card is blocked, its status will be updated to BLOCKED, and any subsequent authorization attempts will return a declined transaction with a decline code of R8. This API is intended for internal use by the operations team, providing more granular control over card status and preventing user-initiated unblocking of cards flagged for risk.

Path Parameters

Name	Type	Required	Description
cardId	string	✅	The unique identifier for the card for which you change the status from ACTIVE to BLOCK.

Request Body

{
  "reason": "string"
}

Body Parameters

Name	Type	Required	Description
reason	string	✅	Specifies the reason for blocking the card. Provide a brief description or choose a predefined code that explains the reason (e.g., lost, stolen, fraud suspected). After blocking the card, this value will appear in the statusReason field when you call the GET /cards/{cardId} endpoint.

Example Request

PUT /api/v1/merchant/cards/{cardId}/block/
Content-Type: application/json

{
  "reason": "fraud suspected"
}

Response

{
  "message": "Card blocked successfully"
}

Response Codes

Status Code	Description
200 OK	Card blocked successfully.
400 Bad Request	Invalid request parameters.
401 Unauthorized	Authentication failed.
404 Not Found	Card not found.
500 Internal Server Error	Server error.