Create client

POST

https://api.freedompay.kz/v5/card-api/client/add

This method is used to create a client in the Freedom Processing system. As a result, the client is assigned a unique identifier client_id, which is then used to link the client to issued payment cards.
After creation, the client_id can be used in other methods, such as updating client data or linking the client to a specific card.

Request

Body Params application/json

Example

{
    "request_id": "string",
    "product_id": 0,
    "branch_id": "string",
    "client": {
        "phone": 0,
        "type": 0,
        "resident": 0,
        "first_name": "string",
        "last_name": "string",
        "middle_name": "string",
        "birthdate": "2019-08-24",
        "email": "string",
        "country": "string",
        "person_id": "string",
        "language": "string",
        "document": "string",
        "external_user_id": "string",
        "address1": {
            "country": "string",
            "postal_code": "string",
            "address_line1": "string",
            "address_line2": "string",
            "address_line3": "string"
        },
        "address2": {
            "country": "string",
            "postal_code": "string",
            "address_line1": "string",
            "address_line2": "string",
            "address_line3": "string"
        }
    },
    "identification_info": {
        "idn_date": "string",
        "identified_by": "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/client/add' \
--header 'Content-Type: application/json' \
--data-raw '{
    "request_id": "string",
    "product_id": 0,
    "branch_id": "string",
    "client": {
        "phone": 0,
        "type": 0,
        "resident": 0,
        "first_name": "string",
        "last_name": "string",
        "middle_name": "string",
        "birthdate": "2019-08-24",
        "email": "string",
        "country": "string",
        "person_id": "string",
        "language": "string",
        "document": "string",
        "external_user_id": "string",
        "address1": {
            "country": "string",
            "postal_code": "string",
            "address_line1": "string",
            "address_line2": "string",
            "address_line3": "string"
        },
        "address2": {
            "country": "string",
            "postal_code": "string",
            "address_line1": "string",
            "address_line2": "string",
            "address_line3": "string"
        }
    },
    "identification_info": {
        "idn_date": "string",
        "identified_by": "string"
    }
}'

Responses

🟢200Success

application/json

Body

Example

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

Modified at 2025-03-01 07:09:12

Statement extended

Edit client