Create business

POST

https://api.freedompay.kz/v5/partner/transfer/business/create

This method is used to register a business client in the IMTS.
The purpose of registration is to create a unique client profile in the system, which can be used to send and receive transfers.
Registration is required before creating a transfer, since each transfer must be associated with a specific client.

All personal data of the client during registration is transmitted in encrypted form.

What the encrypted data includes can be seen in the description on this page -> "Body Params" -> "encrypted_data details"

Request

Header Params

Authorization

string

required

Example:

Bearer <access_token>

Body Params application/json

encrypted_data

string

required

Encrypted client data.

<= 2048 characters

pg_sig

string

required

Request signature.

<= 512 characters

Examples

Request exampleencrypted_data details

{
  "payload": {
    "encrypted_data": "UW/5ZVSTHnsvbhKBage7lNCRBD+MdeYkQZgQg4v2EisNSxA1wE2R6YOBw04ZlefeGOws2Z4P4TcTAD5rTd3Fg6VxLjEHNMlqaE0uIAp3MVpUWvTpLJWB86k0kI3qEvqe3WkqdeZZEY6yyWHOgtygulM1iBv0TMdBlTep1QhD2kmf2dbiD/1BA6EpLLAIi4rdf/zCu2rWvQGxJg4NzBf9K/OszapCQ4VddkW5Kf2ZS6V7y7ruk6FTagSd++LZ9SJZr44E5hk49N1bmulqmnPf0C1pMl+JrZ+LbwGeYo10vCI="
  },
  "pg_sig": "5a1d5f17e4c1f5a3b44c3f29b5e2d77cd11b1b5fefc3dcb5b1c2f8e73f9c22a1"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Request exampleencrypted_data details

curl --location --request POST 'https://api.freedompay.kz/v5/partner/transfer/business/create' \
--header 'Authorization: Bearer <access_token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "payload": {
        "encrypted_data": "UW/5ZVSTHnsvbhKBage7lNCRBD+MdeYkQZgQg4v2EisNSxA1wE2R6YOBw04ZlefeGOws2Z4P4TcTAD5rTd3Fg6VxLjEHNMlqaE0uIAp3MVpUWvTpLJWB86k0kI3qEvqe3WkqdeZZEY6yyWHOgtygulM1iBv0TMdBlTep1QhD2kmf2dbiD/1BA6EpLLAIi4rdf/zCu2rWvQGxJg4NzBf9K/OszapCQ4VddkW5Kf2ZS6V7y7ruk6FTagSd++LZ9SJZr44E5hk49N1bmulqmnPf0C1pMl+JrZ+LbwGeYo10vCI="
    },
    "pg_sig": "5a1d5f17e4c1f5a3b44c3f29b5e2d77cd11b1b5fefc3dcb5b1c2f8e73f9c22a1"
}'

Responses

🟢200Success

application/json

Body

client_uuid

string <uuid>

required

Unique client identifier

status

string

required

Current client status

<= 10 characters

response_time

string

required

Date and time of response generation.

Example

{
  "client_uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "new",
  "response_time": "2025-03-31T10:35:21.000Z"
}

Create person

Create transfer