Fee Calculation - Freedom Pay

Request

Header Params

Authorization

string

required

Example:

Bearer <access_token>

Body Params application/json

originator_type

enum<string>

required

Тип отправителя.

<= 10 characters

Allowed values:

personbusiness

target_country

string

required

Код страны назначения перевода.
(ISO 3166-1 alpha-3)

<= 3 characters

amount_source

number

required

Сумма перевода от отправителя.

<= 15.4

currency_source

string

required

Код валюты отправителя.
(ISO 3166-1 alpha-3)

<= 3 characters

currency_target

string

required

Код валюты получателя.
(ISO 3166-1 alpha-3)

<= 3 characters

pg_sig

string

required

Подпись запроса.

<= 512 characters

Example

{
  "originator_type": "person",
  "target_country": "KAZ",
  "amount_source": 100.00,
  "currency_source": "KZT",
  "currency_target": "UZB"
    },
  "pg_sig": "5a1d5f17e4c1f5a3b44c3f29b5e2d77cd11b1b5fefc3dcb5b1c2f8e73f9c22a1"
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.freedompay.kz/v5/partner/transfer/fees' \
--header 'Authorization: Bearer <access_token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "originator_type": "person",
  "target_country": "KAZ",
  "amount_source": 100.00,
  "currency_source": "KZT",
  "currency_target": "UZB"
    },
  "pg_sig": "5a1d5f17e4c1f5a3b44c3f29b5e2d77cd11b1b5fefc3dcb5b1c2f8e73f9c22a1"
}'

Responses

🟢200Success

application/json

Body

amount_target

number

required

Сумма перевода в валюте получателя.

<= 15.4

currency_target

string

required

Код валюты получателя.
(ISO 3166-1 alpha-3)

<= 3 characters

rate

number

required

Курс обмена

<= 10.8

total_fee

number

required

Общая комиссия сверху перевода, которая будет списана с клиента

<= 10.4

agent_fee

number

required

Комиссия агента

<= 10.4

response_time

string

required

Дата и время формирования ответа.

Example

{
  "amount_target": 105,
  "currency_target": "UZB",
  "rate": "2.5",
  "total_fee": 5,
  "agent_fee": 1.5,
  "response_time": "2025-03-31T10:35:21.000Z"
}