Create transfer

POST

/v5/partner/transfer/create

This method is used to create new requests for transfer funds.
When using this method, the fees are updated again and the transfer is registered in the system.

On-Demand Transfers:
Initiates the transfer, necessarily specifying:
{destination_type} = {phone}
{destination_identifier} = recipient's phone number.
The {agent_id} parameter is not transmitted. The absence of this parameter signals the system that the transfer is a "On Demand" transfer.

Phone-Based Transfers:
Initiates the transfer by specifying:
{destination_type} = an available value depending on the goals and objectives
in {destination_identifier} = Value for the receiving method, for example iban.

The {agent_id} parameter must be present in the request, which identifies the target receiving agent.

The IMTS uses {agent_id} to direct the transfer specifically to the specified financial institution or agent.

Request

Header Params

Body Params application/json

Example

{
    "payload": {
        "client_uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "destination_type": "phone",
        "destination_identifier": "+77076367701",
        "target_agent_id": "abcd-1234-efgh-5678",
        "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 '/v5/partner/transfer/create' \
--header 'Authorization: Bearer <access_token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "payload": {
        "client_uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "destination_type": "phone",
        "destination_identifier": "+77076367701",
        "target_agent_id": "abcd-1234-efgh-5678",
        "target_country": "KAZ",
        "amount_source": 100,
        "currency_source": "KZT",
        "currency_target": "UZB"
    },
    "pg_sig": "5a1d5f17e4c1f5a3b44c3f29b5e2d77cd11b1b5fefc3dcb5b1c2f8e73f9c22a1"
}'

Responses

🟢200Success

application/json

Body

Example

{
  "transfer_uuid": "b84c2a19-b99b-470e-82e2-54785f67a9b3",
  "status": "new",
  "amount_target": 105.00,
  "currency_target": "UZB",
  "rate": "2.5",
  "total_fee": 5.00,
  "agent_fee": 1.50,
  "response_time": "2025-03-31T10:35:21.000Z"
}

Modified at 2025-04-03 09:10:45

Create business

Print application