Block card

POST

https://api.freedompay.kz/v5/card-api/card/block

The card blocking method is used to temporarily or permanently restrict card transactions to prevent fraud, protect the client's funds, or comply with regulatory requirements. One of the types from the directory can be used for blocking.

Request

Body Params application/json

request_id

string

required

Unique request ID in the partner system (UUID).

card_id

string

required

Identifier of the card in Freedom Processing.

description

string

required

Reason (test description from the client).

type

string

optional

Type of blocking.

Example

{
    "request_id": "string",
    "card_id": "string",
    "description": "string",
    "type": "string"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.freedompay.kz/v5/card-api/card/block' \
--header 'Content-Type: application/json' \
--data-raw '{
    "request_id": "string",
    "card_id": "string",
    "description": "string",
    "type": "string"
}'

Responses

🟢200Success

application/json

Body

status

string

required

Status of the request. Possible values:

ok: Request completed successfully.

error: Request completed with an error.

request_status

string

required

Execution status of the request. Refer to the documentation.

string <date-time>

required

Date and time of the request (format: RFC 3339, YYYY-MM-DDThh:mm:ss+hh:mm).

Example

{
    "status": "string",
    "request_status": "string",
    "dt": "2019-08-24T14:15:22Z"
}

Modified at 2025-02-28 06:51:41

Activate card

Unblock card