This method is designed to link a previously created client (using the Create Client method) with a previously issued card (using the Bulk Issue method). Linking a client to a card allows the system to identify the cardholder and use client information for transaction processing, authentication (e.g., 3D Secure), notifications, and other card-related operations. After successful execution, the client will be associated with the specified card, and their data will be used for
Request
Body Params application/json
request_id
string
required
Unique request ID in the partner system (UUID).
client_id
string
required
Identifier of the client in Freedom Processing.
card_id
string
required
Identifier of the card in Freedom Processing.
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/link' \
--header'Content-Type: application/json' \
--data-raw''
Responses
🟢200Success
application/json
Body
status
string
required
Indicates the status of the request. Possible values:
ok: Request completed successfully.
error: Request completed with an error.
request_status
string
required
Indicates the execution status of the request. Refer to the documentation.
dt
string<date-time>
required
Date and time of the request in RFC 3339 format. Format: YYYY-MM-DDThh:mm:ss+hh:mm.
