Card block reasons explain why a card was blocked. They're returned as the reason of card blocks from the Get Cardholder Blocks endpoint and in the Card Block Created webhook. This guide lists existing reasons and their meaning. See the Card Lifecycle guide for how blocks fit into the life of a Card.
Using Block Reasons
Block reasons could be used to tell the cardholder why their card stopped working, or to help them through your support team.
Whether a blocked card can be unfrozen with the Unfreeze Card endpoint is given by unfreezeAllowed in the Card Block Created webhook.
The list of reasons is non-exhaustive and may grow over time, so your integration should tolerate reasons it doesn't recognize.
Reasons
Each card block has one reason, set when the block is created.
| Reason | Meaning |
|---|---|
cvv | Too many incorrect CVV attempts. |
deactivation | The card was deactivated. |
expiry | Too many incorrect expiry date attempts. |
fraud | Blocked because of suspected fraud. |
loststolen | The card was reported lost or stolen. |
pin | Too many incorrect PIN attempts. |
risk | Blocked by Immersve's risk controls. |
suspended | The card was suspended, for example frozen with the Freeze Card endpoint. |
system | Blocked automatically. |