Skip to main content
POST
/
cards
/
{cardId}
/
freeze
Freeze Card
curl --request POST \
  --url https://api.fyatu.com/api/v3/cards/{cardId}/freeze \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "status": 200,
  "message": "Card frozen successfully",
  "data": {
    "id": "crd_8f3a2b1c4d5e6f7890abcdef12345678",
    "status": "FROZEN",
    "frozenAt": "2026-01-17T10:00:00+00:00",
    "activatedAt": null
  },
  "meta": {
    "requestId": "req_a1b2c3d4e5f6",
    "timestamp": "2026-01-17T10:00:00+00:00"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.fyatu.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Temporarily freeze a card. While frozen, all transaction attempts are declined. The card balance is preserved. Unfreeze at any time to restore normal card function.

​
Path Parameters

ParameterTypeDescription
cardIdstringThe card ID

​
Behavior

  • Card status changes to FROZEN
  • All purchases are declined immediately
  • Balance remains intact
  • Card can be unfrozen at any time via POST /cards/{cardId}/unfreeze

​
Error Codes

CodeDescription
RESOURCE_NOT_FOUNDCard not found or belongs to another business
CARD_ALREADY_FROZENCard is already frozen
CARD_NOT_ACTIVECard must be ACTIVE to freeze
Freezing is reversible. Use it when a cardholder reports their card lost or suspects fraud, while you investigate. Terminate the card only if confirmed as compromised.

Authorizations

​
Authorization
string
header
required

JWT access token obtained from /auth/token

Path Parameters

​
cardId
string
required

Response

Card frozen successfully

​
success
boolean
Example:

true

​
status
integer
Example:

200

​
message
string
​
data
object
​
meta
object