Fees

POST

https://api.freedompay.kz/v5/partner/transfer/fees

Performs a preliminary calculation of the commission for a transfer.
The fee depends on the sender type, destination country, transfer amount, and currencies involved.
This method is used to show the client the total transfer cost before initiating the transaction.

Request

Header Params

Authorization

string

required

Example:

Bearer <access_token>

Body Params application/json

originator_type

enum<string>

required

Originator type.

<= 10 characters

Allowed values:

personbusiness

target_country

string

required

Transfer target country code.
(ISO 3166-1 alpha-3)

<= 3 characters

amount_source

number

required

Soursce transfer amount.

<= 15.4

currency_source

string

required

Source currency code.
(ISO 3166-1 alpha-3)

<= 3 characters

currency_target

string

required

Target currency code.
(ISO 3166-1 alpha-3)

<= 3 characters

pg_sig

string

required

Request signature.

<= 512 characters

Example

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

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

Responses

🟢200Success

application/json

Body

amount_target

number

required

Target transfer amount.

<= 15.4

currency_target

string

required

Target currency code.
(ISO 3166-1 alpha-3)

<= 3 characters

rate

number

required

Exchange rate

<= 10.8

total_fee

number

required

The total commission on top of the transfer that will be debited from the client

<= 10.4

agent_fee

number

required

Agent commission

<= 10.4

response_time

string

required

Date and time of response generation.

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"
}

Get agents

Create person