Close card - Freedom Pay

The card closure method is designed to terminate the use of a payment card and deactivate it within the system. This process is necessary in cases where the card is no longer needed, has expired, is being reissued, or at the request of the cardholder.
Once the operation is successfully completed, the card becomes unavailable for any transactions, including payments, cash withdrawals, and top-ups. Card closure is an irreversible operation.

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).

Example

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

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

required

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

Example

{
  "status": "string",
  "request_status": "string",
  "dt": "string"
}