Freeze / Unfreeze

Instantly blocks or resumes a card. Freezes take effect for new authorisations in under a second; in-flight authorisations are not affected.

Freeze

POST/v1/cards/{id}/freeze

curl -X POST https://api.vaultspay.ae/v1/cards/card_01HX7.../freeze \
  -H "Authorization: Bearer sk_test_yourApiKeyHere"

200 OK

{
  "id": "card_01HX71YM6FJ3A8W7T5K6NRB2DN",
  "object": "card",
  "status": "frozen",
  "frozen_at": "2026-04-24T14:52:03Z"
}

POST/v1/cards/{id}/unfreeze

curl -X POST https://api.vaultspay.ae/v1/cards/card_01HX7.../unfreeze \
  -H "Authorization: Bearer sk_test_yourApiKeyHere"

200 OK

{
  "id": "card_01HX71YM6FJ3A8W7T5K6NRB2DN",
  "object": "card",
  "status": "active"
}

Use freeze for temporary blocks (user is travelling, card lost but may be found, fraud suspected).
Use terminate when the card must never be used again (confirmed stolen, user offboarding).