Create terminal

Developing

POST

https://api.freedompay.kz/v5/partner/product/add

INFO

This API is used only when you need to create an additional terminal for an existing merchant in the system. One API call creates 1 terminal.

In the company object, the merchant_id field must contain the MID generated by us and obtained from the /v5/partner/client/add API.

The generated terminal_number can be found in the response of the /v5/partner/client/request/status API.

To create another terminal for the same merchant, send another request to this URL.

Interaction diagram:

Request

Body Params application/json

Example

{
    "request_id": "828cf71d-a447-4a67-a149-c1df8bc197ca",
    "company": {
        "company_id": "7cebad9e-dd7a-49c9-afe6-d880d58c999a",
        "merchant_id": 60000025
    },
    "product": {}
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.freedompay.kz/v5/partner/product/add' \
--header 'Content-Type: application/json' \
--data-raw '{
    "request_id": "828cf71d-a447-4a67-a149-c1df8bc197ca",
    "company": {
        "company_id": "7cebad9e-dd7a-49c9-afe6-d880d58c999a",
        "merchant_id": 60000025
    },
    "product": {}
}'

Responses

🟢200Success

application/json

Body

Example

{
    "dt": "2025-06-24T14:15:22Z",
    "status": "ok",
    "request_status": "process"
}

Modified at 2025-07-24 11:30:51

Request status

Overview