Получение транзакции по ID

GET /api/transactions/:id

Возвращает подробную информацию о транзакции мерчанта по UUID транзакции.

Запрос

Параметры Path

id uuidобязательно

UUID транзакции.

Пример: 11111111-1111-4111-8111-111111111111

Ответы

application/json

Схема
Пример

Схема

transactionIduuid

ID транзакции.

Пример: 11111111-1111-4111-8111-111111111111

paymentMethodTypestring

Тип платёжного метода.

Возможные значения: [INTERNAL_OWN, INTERNAL_OTHERS, CRYPTOWALLET, CRYPTO_EXTERNAL, BANK_CARD, BANK_CARD_EXTENDED, VISA, VISA_EXTENDED, MASTERCARD, MASTERCARD_EXTENDED, SWIFT, SEPA, SWIFT_EUR, LOCAL_BANK_TRANSFER, EPS_LOCAL_BANK_TRANSFER, EPS_SWIFT, EPS_CIPS, EPS_FPS]

Пример: INTERNAL_OWN

transactionTypestring

Тип транзакции.

Возможные значения: [DEPOSIT, INTERNAL_TRANSFER_OTHER, INTERNAL_TRANSFER_OWN, SYSTEM_PAYMENT, WITHDRAWAL, REFUND]

Пример: DEPOSIT

statusstring

Статус.

Возможные значения: [PENDING, COMPLETED, CANCELED, REFUNDED]

Пример: COMPLETED

directionstring

Направление.

Возможные значения: [DEPOSIT, WITHDRAWAL]

Пример: DEPOSIT

transactionDirectionstring

Направление транзакции.

Возможные значения: [INCOMING, OUTGOING, EXCHANGE]

Пример: OUTGOING

currencystring

Валюта.

Возможные значения: [USD, EUR, BTC, BNB, ETH, LTC, XRP, USDT, USDT_BEP20, USDT_ERC20, USDT_TRC20, USDT_SOL, USDT_AVAXC, USDT_POL, USDT_OP, USDT_ARB, TRX, USDC, USDC_ERC20, USDC_BEP20, TON, SOL, AVAX, POL, USDT_TON, USDC_ARB, USDC_OP, USDC_POL, USDC_AVAXC, USDC_SOL]

Пример: USD

amountnumber

Сумма.

Пример: 10.25

createdAtdate-time

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

paymentScopestring

Область платежа.

Возможные значения: [PERSONAL, BUSINESS, MERCHANT_API, PAYMENT_GATEWAY]

Пример: PERSONAL

orderIdstring

ID заказа мерчанта.

Пример: ORDER_123456

walletSrcIdstring

ID кошелька отправителя.

Пример: USD880390848110

walletDestIdstring

ID кошелька получателя.

Пример: USD880390848110

fullCommissionnumber

Полная комиссия.

Пример: 10.25

commentstring

Комментарий.

Пример: Sandbox transfer note

cryptoCurrencyTxHashstring

Хеш криптовалютной транзакции.

Пример: 4e3ab7d90c8f254ad96e38d5471b72411d4cc47a6cd317a15ca020d8212b0f5e

completedAtdate-time

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

senderstring

Отправитель. В зависимости от платёжного метода это email, ID кошелька, криптовалютный адрес, маскированный номер карты или IBAN.

Пример: [email protected]

receiverstring

Получатель. В зависимости от платёжного метода это email, ID кошелька, криптовалютный адрес, маскированный номер карты или IBAN.

Пример: LXGkekTDFZDCNUDYcPaRHERydnT1oSnwDx

parentTransactionIduuid

ID родительской транзакции.

Пример: 11111111-1111-4111-8111-111111111111

amountIncomenumber

Сумма поступления.

Пример: 10.25

currencyIncomestring

Валюта поступления.

Возможные значения: [USD, EUR, GBP, TRY, VND, ARS, AUD, BDT, CAD, CLP, COP, DOP, EGP, HKD, INR, IDR, JPY, MYR, MXN, MAD, NPR, NZD, PKR, PEN, PHP, SGD, ZAR, KRW, LKR, THB, AED, CNY, CNH, BTC, BNB, ETH, LTC, XRP, USDT, USDT_BEP20, USDT_ERC20, USDT_TRC20, USDT_SOL, USDT_AVAXC, USDT_POL, USDT_OP, USDT_ARB, TRX, USDC, USDC_ERC20, USDC_BEP20, TON, SOL, AVAX, POL, USDT_TON, USDC_ARB, USDC_OP, USDC_POL, USDC_AVAXC, USDC_SOL]

Пример: USD

{
  "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": "PERSONAL",
  "orderId": "ORDER_123456",
  "walletSrcId": "USD880390848110",
  "walletDestId": "USD880390848110",
  "fullCommission": 10.25,
  "comment": "Sandbox transfer note",
  "cryptoCurrencyTxHash": "4e3ab7d90c8f254ad96e38d5471b72411d4cc47a6cd317a15ca020d8212b0f5e",
  "completedAt": "2026-01-15T10:30:00",
  "sender": "[email protected]",
  "receiver": "LXGkekTDFZDCNUDYcPaRHERydnT1oSnwDx",
  "parentTransactionId": "11111111-1111-4111-8111-111111111111",
  "amountIncome": 10.25,
  "currencyIncome": "USD"
}

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

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": {}
      }
    ]
  }
}

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

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": {}
      }
    ]
  }
}

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

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": {}
      }
    ]
  }
}

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

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": {}
      }
    ]
  }
}

Получение транзакции по ID

/api/transactions/:id

Запрос​

Параметры Path

Ответы​

Запрос

Ответы