Unfreeze a card
curl --request POST \
--url https://sandbox-api.fyatu.com/api/v3.20/cards/{id}/unfreeze \
--header 'Authorization: Bearer <token>'import requests
url = "https://sandbox-api.fyatu.com/api/v3.20/cards/{id}/unfreeze"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://sandbox-api.fyatu.com/api/v3.20/cards/{id}/unfreeze', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sandbox-api.fyatu.com/api/v3.20/cards/{id}/unfreeze",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://sandbox-api.fyatu.com/api/v3.20/cards/{id}/unfreeze"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://sandbox-api.fyatu.com/api/v3.20/cards/{id}/unfreeze")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox-api.fyatu.com/api/v3.20/cards/{id}/unfreeze")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"status": 200,
"message": "Card unfrozen",
"data": {
"id": "crd_01HXYZ5555ABCDEF1111",
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"productId": "prd_01HXYZ7777ABCDEF3333",
"status": "ACTIVE",
"cardType": "VIRTUAL",
"cardBrand": "VISA",
"maskedPan": "**** **** **** 4242",
"last4": "4242",
"expirationDate": "05/2029",
"currency": "USD",
"createdAt": "2026-05-22T09:00:00Z",
"updatedAt": "2026-05-26T10:15:00Z"
},
"meta": {
"requestId": "req_a1b2c3d4e5f6a7b8c9d0e1f2",
"platform": "Fyatu CaaS",
"timestamp": "2026-05-26T10:15:00Z"
}
}Cards
Unfreeze Card
Restore a frozen card to active status. POST /cards//unfreeze. Requires cards:write scope.
POST
/
cards
/
{id}
/
unfreeze
Unfreeze a card
curl --request POST \
--url https://sandbox-api.fyatu.com/api/v3.20/cards/{id}/unfreeze \
--header 'Authorization: Bearer <token>'import requests
url = "https://sandbox-api.fyatu.com/api/v3.20/cards/{id}/unfreeze"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://sandbox-api.fyatu.com/api/v3.20/cards/{id}/unfreeze', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sandbox-api.fyatu.com/api/v3.20/cards/{id}/unfreeze",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://sandbox-api.fyatu.com/api/v3.20/cards/{id}/unfreeze"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://sandbox-api.fyatu.com/api/v3.20/cards/{id}/unfreeze")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox-api.fyatu.com/api/v3.20/cards/{id}/unfreeze")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"status": 200,
"message": "Card unfrozen",
"data": {
"id": "crd_01HXYZ5555ABCDEF1111",
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"productId": "prd_01HXYZ7777ABCDEF3333",
"status": "ACTIVE",
"cardType": "VIRTUAL",
"cardBrand": "VISA",
"maskedPan": "**** **** **** 4242",
"last4": "4242",
"expirationDate": "05/2029",
"currency": "USD",
"createdAt": "2026-05-22T09:00:00Z",
"updatedAt": "2026-05-26T10:15:00Z"
},
"meta": {
"requestId": "req_a1b2c3d4e5f6a7b8c9d0e1f2",
"platform": "Fyatu CaaS",
"timestamp": "2026-05-26T10:15:00Z"
}
}Overview
Restores a frozen card toACTIVE status. Transactions are accepted again immediately. The card balance is unchanged.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
id | string | The card ID (prefix crd_) |
Request Body
This endpoint has no request body.Example
curl -X POST https://api.fyatu.com/api/v3.20/cards/crd_01HXYZ5555ABCDEF1111/unfreeze \
-H "Authorization: Bearer $FYATU_API_KEY"
const resp = await fetch(
'https://api.fyatu.com/api/v3.20/cards/crd_01HXYZ5555ABCDEF1111/unfreeze',
{
method: 'POST',
headers: { 'Authorization': `Bearer ${process.env.FYATU_API_KEY}` }
}
);
const body = await resp.json();
console.log(body.data.status); // "ACTIVE"
import os, requests
resp = requests.post(
'https://api.fyatu.com/api/v3.20/cards/crd_01HXYZ5555ABCDEF1111/unfreeze',
headers={'Authorization': f'Bearer {os.environ["FYATU_API_KEY"]}'}
)
card = resp.json()['data']
print(card['status']) # ACTIVE
Success Response (200)
Returns the updated card withstatus: ACTIVE and frozenAt: null:
{
"success": true,
"status": 200,
"message": "Card unfrozen",
"data": {
"id": "crd_01HXYZ5555ABCDEF1111",
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"productId": "prd_01HXYZ7777ABCDEF3333",
"status": "ACTIVE",
"cardType": "VIRTUAL",
"cardBrand": "VISA",
"maskedPan": "**** **** **** 4242",
"last4": "4242",
"expirationDate": "05/2029",
"currency": "USD",
"createdAt": "2026-05-22T09:00:00Z",
"updatedAt": "2026-05-26T10:15:00Z"
},
"meta": {
"requestId": "req_01HXY123456ABCDEF",
"platform": "Fyatu CaaS",
"timestamp": "2026-05-26T10:15:00Z"
}
}
Webhook
ACARD_UNFROZEN event fires after a successful unfreeze:
{
"event": "CARD_UNFROZEN",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-26T10:15:00Z",
"data": {
"cardId": "crd_01HXYZ5555ABCDEF1111",
"status": "ACTIVE",
"cardType": "VIRTUAL",
"cardholderId": "chl_01HXYZ1234ABCDEF5678"
}
}
The change is applied at the card issuer before this endpoint returns, so the status you get back
is one the network will actually honour. If the issuer refuses, the call returns
CARD_STATE_CHANGE_REFUSED and the card keeps its previous status — a card shown as frozen is
always a card the issuer is declining, and one shown as active is always one it will authorise.Error Codes
| Code | HTTP | Cause |
|---|---|---|
CARD_NOT_FOUND | 404 | Card does not exist or belongs to another business/environment |
CARD_NOT_FROZEN | 409 | Card is not currently frozen |
CARD_ALREADY_TERMINATED | 422 | Cannot unfreeze a terminated card |
CARD_STATE_CHANGE_REFUSED | 422 | The issuer refused the change for a stated reason. The card is unchanged |
CARD_STATE_CHANGE_REFUSED | 503 | The issuer could not be reached or refused for a reason we do not surface. The card is unchanged — retry shortly |
INSUFFICIENT_SCOPE | 403 | Key lacks cards:write scope |

