Freeze card - Framnex for Developers

Early access - contact your account manager to enable card issuing for your platform.

Temporarily freezes an active card, for example while the cardholder looks for a misplaced card. New payments with a frozen card are declined. Unfreeze the card with POST /baas/Cards/{id}/unfreeze. Freezing a frozen card has no effect.

The response contains the card in the frozen state, and the cardStateChanged webhook is sent.

Errors: 404 Not Found if the card does not exist; 422 Unprocessable Content if the card is not active or frozen.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "id": "0f8e2b6a-3c4d-4e5f-9a1b-7c2d3e4f5a6b",
    "externalId": "card-000123",
    "clientId": "5e505642-9024-474d-9434-e5a44f505cc5",
    "cardProductId": "06776ac8-abe1-475b-92ee-72405c7b0e60",
    "cardholderId": "29de7042-59a4-4af9-acc9-c12b40cdf661",
    "cardholderName": "ANNA SCHMIDT",
    "cardName": "Marketing subscriptions",
    "type": "virtual",
    "network": "visa",
    "currency": "USD",
    "state": "issuing",
    "stateReason": null,
    "last4": "4821",
    "expirationMonth": 9,
    "expirationYear": 2029,
    "accountId": "3d07c219-0a88-45be-9cfc-91e9d095a1e9",
    "limits": [
        {
            "amount": 1000,
            "interval": "perAuthorization"
        }
    ],
    "shipping": {
        "address": {
            "streetLine1": "string",
            "streetLine2": "string",
            "city": "string",
            "state": "string",
            "zip": "string",
            "country": "string"
        },
        "recipientName": "Anna Schmidt",
        "phoneNumber": "+4930123456789"
    },
    "createdAt": "2026-09-29T10:00:00Z"
}

🟠400Bad Request

🟠404Record Not Found

🟠422Parameter Error

🔴500Server Error