Permanently block a card

Learn the process for permanently blocking a card, for instance, if it is reported lost or stolen. This guide explains how to permanently deactivate a card, preventing further use.

Blocked cards' sensitive card information, such as card number and security code (CVV/CVC), will not be accessible.

Use Cases

1. You want to permanently block/delete/unlink a specific card from the user account.
2. You want to disassociate a card from a user account and free up a card slot from the allowed cards per user limit.
3. You want to set the card status from the locked (temporary) to a blocked (permanent) state.
4. You want to set the card status directly from the active to a blocked (permanent) state, provided there are no pending unsettled transactions made in the card.
5. You want to permanently block a card in cases of card loss, damage, and theft.
6. You want to block a card due to contractual reasons permanently.
7. You want to add a feature to your application that allows users to self-block or delete their cards.

Prerequisites

1. The user profile risk assessment status must not be risk_flagged.
2. The user profile must be in an active status.
3. The user must have an approved KYC or KYB status.
4. The user account or wallet must be in an active status.
5. The user card must be in an locked or active status.
6. The user card has no pending transactions that need to be settled.

API Workflow

 
curl --location --request DELETE 'https://{{cards_base_url}}/{{program_code}}/v1/users/wallets/cards/180ac588b91dc6bff6a5d42a671d1d6a' \
  --header 'X-Auth-User-Id: {{user_id}}' \
  --header 'Authorization: ••••••' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data 'type=damaged'

 
{
  "id": "180ac588b91dc6bff6a5d42a671d1d6a",
  "number": "5545XXXXXXXX0000",
  "status": "blocked"
}

 
curl --location --request PUT 'https://{{cards_base_url}}/{{program_code}}/v2/users/wallets/cards/{{card_id}}/statuses' \
--header 'X-Auth-User-ID: {{user_id}}' \
--header 'Content-Type: application/json' \
--header 'Authorization: ••••••' \
--data '{
  "action": "BLOCK",
  "origin": "USER",
  "reason": "LOST_CARD"
}

 
{
    "id": "{{card_id}}",
    "status": "BLOCKED",
    "reason": "LOST_CARD",
    "origin": "USER",
    "updated_at": "2026-03-17 02:14:23.426001434 +0000 UTC"
}

Related Links

• Card overview
• Create your card product
• Issue a card
• Manage cards
• Retrieve users cards
• Retrieve non-sensitive card information
• Retrieve sensitive card information
• Set a card PIN
• Suspend an active card
• Reactivate a suspended card
• Card spending control
• Card payment authentication
• Card payments
• Manage card security