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"
  },
  "meta": {
    "requestId": "req_a1b2c3d4e5f6",
    "timestamp": "2026-01-17T10:00:00+00:00"
  }
}

​
Overview

Temporarily freeze a card to prevent any transactions. The card can be unfrozen later using the Unfreeze Card endpoint. The card balance is preserved while frozen.

​
Path Parameters

ParameterTypeDescription
cardIdstringThe unique card identifier

​
Example Usage

<?php
$cardId = 'crd_8f3a2b1c4d5e6f7890abcdef12345678';

$ch = curl_init('https://api.fyatu.com/api/v3/cards/' . $cardId . '/freeze');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $accessToken
    ]
]);

$response = curl_exec($ch);
$result = json_decode($response, true);

if ($result['success']) {
    echo "Card status: " . $result['data']['status'] . "\n";
}

​
Error Responses

StatusError CodeDescription
400CARD_TERMINATEDCannot freeze a terminated card
409ALREADY_FROZENCard is already frozen (auto-syncs local status)
500FREEZE_FAILEDFailed to freeze card at the bank partner
Use card freezing for temporary security concerns. If a card is compromised or lost, freeze it immediately while you investigate.

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