Создание внутреннего перевода между своими кошельками

POST 
/api/withdrawal/internal-own

Создаёт внутренний перевод между кошельками мерчанта и возвращает созданную транзакцию.

Запрос

application/json

Body

Тело запросаобязательно

Данные для создания внутреннего перевода между своими кошельками.

srcWalletIdstringnullable
ID кошелька отправителя.
Пример: USD880390848110
amountnumberобязательно
Сумма.
Возможные значения: >= 0
Пример: 10.25
actionstringобязательно
Действие.
Возможные значения: [GIVE, GET]
Пример: GIVE
notestringnullable
Примечание.
Возможные значения: <= 255 символов
Пример: Sandbox transfer note
srcCurrencystringnullable
Исходная валюта.
Возможные значения: [USD, EUR, USDT, USDC, BTC, ETH, SOL, TRX, XRP, TON, LTC]
Пример: USD
destWalletIdstringnullable
ID кошелька получателя.
Пример: USD880390848110
destCurrencystringnullable
Валюта получения.
Возможные значения: [USD, EUR, USDT, USDC, BTC, ETH, SOL, TRX, XRP, TON, LTC]
Пример: USD

Пример

{
  "srcWalletId": "USD880390848110",
  "amount": 10.25,
  "action": "GIVE",
  "note": "Sandbox transfer note",
  "srcCurrency": "USD",
  "destWalletId": "USD880390848110",
  "destCurrency": "USD"
}

Ответы

200

OK

application/json

Схема

Схема

transactionIduuid
ID транзакции.
Пример: 11111111-1111-4111-8111-111111111111
paymentMethodTypestring
Тип платёжного метода.
Возможные значения: [INTERNAL_OWN]
Пример: INTERNAL_OWN
transactionTypestring
Тип транзакции.
Возможные значения: [INTERNAL_TRANSFER_OWN]
Пример: INTERNAL_TRANSFER_OWN
statusstring
Статус.
Возможные значения: [PENDING, COMPLETED, CANCELED, REFUNDED]
Пример: COMPLETED
directionstring
Направление.
Возможные значения: [DEPOSIT, WITHDRAWAL]
Пример: DEPOSIT
transactionDirectionstring
Направление транзакции.
Возможные значения: [INCOMING, OUTGOING, EXCHANGE]
Пример: OUTGOING
currencystring
Валюта.
Возможные значения: [USD, EUR, USDT, USDC, BTC, ETH, SOL, TRX, XRP, TON, LTC]
Пример: USD
amountnumber
Сумма.
Пример: 10.25
createdAtdate-time

Время создания.

paymentScopestring
Область платежа.
Возможные значения: [MERCHANT_API]
Пример: MERCHANT_API
orderIdstring
ID заказа.
Пример: ORDER_123456
walletSrcIdstring
ID кошелька отправителя.
Пример: USD880390848110
walletDestIdstring
ID кошелька получателя.
Пример: USD880390848110
fullCommissionnumber
Полная комиссия.
Пример: 10.25
commentstring
Комментарий.
Пример: Sandbox transfer note
cryptoCurrencyTxHashstring
Хеш криптовалютной транзакции.
Пример: 4e3ab7d90c8f254ad96e38d5471b72411d4cc47a6cd317a15ca020d8212b0f5e
completedAtdate-time

Время завершения.

Пример

{
  "transactionId": "11111111-1111-4111-8111-111111111111",
  "paymentMethodType": "INTERNAL_OWN",
  "transactionType": "INTERNAL_TRANSFER_OWN",
  "status": "CREATED",
  "direction": "WITHDRAWAL",
  "transactionDirection": "EXCHANGE",
  "currency": "USD",
  "amount": 10.25,
  "createdAt": "2026-01-15T10:30:00",
  "paymentScope": "MERCHANT_API",
  "orderId": "ORDER_123456",
  "walletSrcId": "USD880390848110",
  "walletDestId": "USD880390848110",
  "fullCommission": 10.25,
  "comment": "Sandbox transfer note",
  "cryptoCurrencyTxHash": "4e3ab7d90c8f254ad96e38d5471b72411d4cc47a6cd317a15ca020d8212b0f5e",
  "completedAt": "2026-01-15T10:30:00"
}

400

Некорректный запрос. Запрос сформирован неверно или содержит недопустимые параметры.

application/json

Схема

Схема

statusstringобязательно
Статус ответа.
Возможные значения: [error]
Пример: error
data objectобязательно
Данные ответа с ошибкой.
errors object[]обязательно
Список ошибок, возвращённых для запроса.
Array [
errorMessagestringобязательно
Постоянный машиночитаемый код ошибки.
Пример: disabled
errorTypestringобязательно
Категория ошибки.
Пример: FORM
errorIdstringобязательно
Короткий уникальный идентификатор ошибки для поддержки и логов.
Пример: errTest1234
errorDescriptionstringобязательно
Описание ошибки для человека.
Пример: REQUESTED OPERATION IS DISABLED FOR THE MERCHANT API
errorFieldstringnullable
Поле запроса, к которому относится ошибка, если есть.
Пример: null
paramsobject[]обязательно
Дополнительные параметры ошибки.
requestParamsobjectобязательно
Параметры запроса, сохранённые для диагностики.
]

Пример

{
  "status": "error",
  "data": {
    "errors": [
      {
        "errorMessage": "disabled",
        "errorType": "FORM",
        "errorId": "errTest1234",
        "errorDescription": "REQUESTED OPERATION IS DISABLED FOR THE MERCHANT API",
        "errorField": null,
        "params": [],
        "requestParams": {}
      }
    ]
  }
}

401

Не авторизован. Заголовки аутентификации мерчанта отсутствуют или недействительны.

application/json

Схема

Схема

statusstringобязательно
Статус ответа.
Возможные значения: [error]
Пример: error
data objectобязательно
Данные ответа с ошибкой.
errors object[]обязательно
Список ошибок, возвращённых для запроса.
Array [
errorMessagestringобязательно
Постоянный машиночитаемый код ошибки.
Пример: userDoesNotExistException
errorTypestringобязательно
Категория ошибки.
Пример: GENERAL
errorIdstringобязательно
Короткий уникальный идентификатор ошибки для поддержки и логов.
Пример: errTest1234
errorDescriptionstringобязательно
Описание ошибки для человека.
Пример: NOT FOUND API WITH ACCOUNT_EMAIL: [email protected]
errorFieldstringnullable
Поле запроса, к которому относится ошибка, если есть.
Пример: null
paramsobject[]обязательно
Дополнительные параметры ошибки.
requestParamsobjectобязательно
Параметры запроса, сохранённые для диагностики.
]

Пример

{
  "status": "error",
  "data": {
    "errors": [
      {
        "errorMessage": "userDoesNotExistException",
        "errorType": "GENERAL",
        "errorId": "errTest1234",
        "errorDescription": "NOT FOUND API WITH ACCOUNT_EMAIL: [email protected]",
        "errorField": null,
        "params": [],
        "requestParams": {}
      }
    ]
  }
}

404

Не найдено. Запрошенный ресурс не существует.

application/json

Схема

Схема

statusstringобязательно
Статус ответа.
Возможные значения: [error]
Пример: error
data objectобязательно
Данные ответа с ошибкой.
errors object[]обязательно
Список ошибок, возвращённых для запроса.
Array [
errorMessagestringобязательно
Постоянный машиночитаемый код ошибки.
Пример: resourceNotFound
errorTypestringобязательно
Категория ошибки.
Пример: GENERAL
errorIdstringобязательно
Короткий уникальный идентификатор ошибки для поддержки и логов.
Пример: errTest1234
errorDescriptionstringобязательно
Описание ошибки для человека.
Пример: Resource not found
errorFieldstringnullable
Поле запроса, к которому относится ошибка, если есть.
Пример: null
paramsobject[]обязательно
Дополнительные параметры ошибки.
requestParamsobjectобязательно
Параметры запроса, сохранённые для диагностики.
]

Пример

{
  "status": "error",
  "data": {
    "errors": [
      {
        "errorMessage": "resourceNotFound",
        "errorType": "GENERAL",
        "errorId": "errTest1234",
        "errorDescription": "Resource not found",
        "errorField": null,
        "params": [],
        "requestParams": {}
      }
    ]
  }
}

500

Внутренняя ошибка сервера. Непредвиденная ошибка, обратитесь в поддержку

application/json

Схема

Схема

statusstringобязательно
Статус ответа.
Возможные значения: [error]
Пример: error
data objectобязательно
Данные ответа с ошибкой.
errors object[]обязательно
Список ошибок, возвращённых для запроса.
Array [
errorMessagestringобязательно
Постоянный машиночитаемый код ошибки.
Пример: internalServerError
errorTypestringобязательно
Категория ошибки.
Пример: GENERAL
errorIdstringобязательно
Короткий уникальный идентификатор ошибки для поддержки и логов.
Пример: errTest1234
errorDescriptionstringобязательно
Описание ошибки для человека.
Пример: Internal server error
errorFieldstringnullable
Поле запроса, к которому относится ошибка, если есть.
Пример: null
paramsobject[]обязательно
Дополнительные параметры ошибки.
requestParamsobjectобязательно
Параметры запроса, сохранённые для диагностики.
]

Пример

{
  "status": "error",
  "data": {
    "errors": [
      {
        "errorMessage": "internalServerError",
        "errorType": "GENERAL",
        "errorId": "errTest1234",
        "errorDescription": "Internal server error",
        "errorField": null,
        "params": [],
        "requestParams": {}
      }
    ]
  }
}