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 samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl--location--request POST 'https://api.freedompay.kz/v5/card-api/card/close' \
--header'Content-Type: application/json' \
--data-raw''
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.
dt
string
required
Date and time of the request (format: RFC 3339, YYYY-MM-DDThh:mm:ss+hh:mm).
