Freeze a card

A PUT request sent to freeze a card.
If you believe a cardholder's card may have been lost, stolen, or involved in potential fraudulent behavior,
you can freeze the card.
This freeze will prevent any new transactions but will still permit the following actions:

  • ongoing payments
  • authorization requests connected to a prior transaction, such as an additional authorization
  • refunds
  • chargebacks
  • reversals
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
length between 40 and 40

A Card identifier. Begins with 'crd-' followed by a v4 UUID

Body Params

Card object freeze information.

boolean
Defaults to true

Whether to also freeze card tokens created on Apple Pay or Google Pay.

Responses

400

The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing).

401

Although the HTTP standard specifies "unauthorized", semantically this response means "unauthenticated". That is, the client must authenticate itself to get the requested response.

403

The client does not have access rights to the content; that is, it is unauthorized, so the server is refusing to give the requested resource. Unlike 401 Unauthorized, the client's identity is known to the server.

422

The request was well-formed but was unable to be followed due to semantic errors.

429

The user has sent too many requests in a given amount of time ("rate limiting").

500

The server has encountered a situation it does not know how to handle.

Language
LoadingLoading…
Response
Choose an example:
application/json