Fees - Freedom Pay

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

signature

string

required

Request signature.

<= 512 characters

Example

{
  "payload": {
    "originator_type": "person",
    "target_country": "UZB",
    "source_amount": 100.00,
    "source_currency": "KZT",
    "target_currency": "UZS"
  },
  "signature": "3d1761d7f80d110b367f54740829f6202a6fc77ac28b17e3e07017b9226a3efa"
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/v5/partner/transfer/fees' \
--header 'Authorization: Bearer <access_token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "payload": {
    "originator_type": "person",
    "target_country": "UZB",
    "source_amount": 100.00,
    "source_currency": "KZT",
    "target_currency": "UZS"
  },
  "signature": "3d1761d7f80d110b367f54740829f6202a6fc77ac28b17e3e07017b9226a3efa"
}'

Responses

🟢200Success

application/json

Body

target_amount

number

required

Target transfer amount.

<= 15.4

target_currency

string

required

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

<= 3 characters

rate

number

required

Exchange rate

<= 10.8

fees

object

required

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

type

enum<string>

required

Type of commission.

<= 20 characters

Allowed values:

sourcetargettotal

currency

string

required

Commission currency.

amount

number

required

Fixed amount of the commission

<= 15.2

percent

number

required

Commission percentage

<= 5.4

response_time

string

required

Date and time of response generation.

signature

string

required

Request signature.

<= 512 characters

Example

{
  "state": true,
  "response_time": "2025-07-03T06:08:34.134051Z",
  "payload": {
    "target_amount": 2506,
    "target_currency": "UZS",
    "rate": 25.06,
    "fees": [
      {
        "type": "SENDER",
        "currency": "KZT",
        "amount": 174.95,
        "percent": 1.7495
      },
      {
        "type": "TOTAL",
        "currency": "KZT",
        "amount": 123.47,
        "percent": 1.2347
      }
    ]
  },
  "signature": "3d1761d7f80d110b367f54740829f6202a6fc77ac28b17e3e07017b9226a3efa"
}