Skip to main content
PUT
Freeze a card

Overview

PUT /cards/{id}/freeze temporarily disables a card. While frozen, the card cannot authorize new transactions, but the balance is preserved and pending settlements continue to clear. Use PUT /cards/{id}/unfreeze to reactivate. For permanent disable with automatic balance refund, use POST /cards/{id}/terminate instead.

When to use it

  • A customer reports a suspicious transaction and you want to halt further charges while you investigate.
  • The cardholder is going on leave and you want to prevent unintended charges (e.g. recurring subscriptions).
  • You want a “kill switch” that you can reverse if needed.

Prerequisites

  • The card must belong to your company.
  • Card status must be ACTIVE (not already FROZEN, TERMINATED, etc.).

Request

Headers

Path parameters

Query parameters

Body

None.

Response

200 — Success

Error responses

Webhooks fired

None today. Card status changes to FROZEN immediately and is reflected in subsequent GET /cards and GET /cards/{id} responses.

Code examples

cURL
Node.js (axios)

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string<uuid>
required

Response

Card frozen successfully