📄 Транзакция

Транзакция — это запись финансового действия на платформе, отражающая поступления, выплаты, переводы между кошельками, либо взаимодействие с внешними платежными системами.

💡 Особенности работы:

• Транзакция фиксирует источник и назначение средств (клиент, инвойс, юнит, субсчет).

• Может содержать информацию о комиссии, курсе валюты и статусе обработки.

• Каждая транзакция имеет уникальный идентификатор в системе и в блокчейне (txId).

• Транзакции могут быть поступления (payin/deposit), выплаты (payout/withdrawals) или внутренние переводы.

---

📘 Основная структура

{
    "id": 32942,
    "createdAt": "2025-11-04T14:29:12.727Z",
    "updatedAt": "2025-11-04T14:29:12.772Z",
    "amount": "11",
    "availableAmount": 10,
    "serviceFee": 1,
    "remainingBalance": "254372.674654",
    "fee": null,
    "refillFee": null,
    "paymentOrderId": null,
    "externalPaymentOrderId": null,
    "currency": "USDT",
    "network": "ERC20",
    "type": "REFILL",
    "status": "completed",
    "txId": "0xf986b22ac71da277b8fc49f4870185cc3b592ceca372a954a4de023654de971f",
    "addressTo": "0xF45049b86A3dB4310CFC12eE6d25C4B60f95489f",
    "addressFrom": "0x7A6D2ac37c43ECd60eF0b14765588BB4481B8514",
    "walletFromName": "walletA",
    "walletToName": "walletB",
    "riskScore": 0.38,
    "direction": "payin",
    "origin": "outside_our_topup",
    "confirmations": 43,
    "payload": {},
    "externalId": 2193,
    "manager": null,
    "clientId": null,
    "unitId": 99,
    "invoiceId": null,
    "exchangeId": null,
    "nativeRate": "0.0002858674289798",
    "usdtRate": "1",
    "annotation": null,
    "subId": null,
    "errorText": null,
    "change": null,
    "remainingBalance": "11",
    "massPayoutId": null,
    "client": null,
    "invoice": null,
    "category": {},
    "unit": {// entity},
    "exchange": null,
    "totalFee": "0"
}

🔹 Статусы транзакций

Статус	Описание
created	Транзакция создана, но не начата обработка.
pending	Транзакция ожидает подтверждения или запуска.
processing	Транзакция в процессе выполнения.
completed	Транзакция успешно завершена.
failed	Транзакция завершилась ошибкой.

---

🔹 Типы транзакций

Тип	Описание
REFILL	Пополнение кошелька или счета.
WITHDRAWALS	Выплата или вывод средств.
FEE	Комиссия за обработку или перевод.

---

🔹 Направление (direction)

Direction	Описание
payin	Средства поступили на кошелек
payout	Средства списаны с кошелька

---

🔹 Источник (Origin)

Источник фиксируется только для входящих транзакций.

Direction	Описание
outside_topup	Пополнение кошелька из вне
outside_our_topup	Пополнение из адресов системы (внутренний перевод)

🧩 Поля сущности

Поле	Тип	Описание
id	number	Уникальный идентификатор транзакции.
createdAt	string	Дата и время создания транзакции.
updatedAt	string	Дата и время последнего обновления.
amount	string	Сумма транзакции (может быть отрицательной для выплат).
availableAmount	string	Сумма доступная для использования или перевода после вычета комиссии.
serviceFee	string	Комиссия платформы за обработку транзакции.
fee	string	Комиссия сети за перевод.
refillFee	string	Комиссия за пополнение (если есть).
paymentOrderId	number	Идентификатор внутреннего платежного ордера.
externalPaymentOrderId	string	Идентификатор внешнего платежа.
currency	string	Валюта транзакции.
network	string	Сеть транзакции (BTC, ERC20, TRC20 и т.д.).
type	string	Тип транзакции (REFILL, WITHDRAWALS, FEE).
status	string	Статус транзакции (CREATED, PENDING, PROCESSING, COMPLETED, FAILED).
txId	string	Хеш транзакции в блокчейне.
addressFrom	string	Адрес отправителя.
addressTo	string	Адрес получателя.
direction	string	Направление транзакции (payin, payout).
confirmations	number	Количество подтверждений в блокчейне.
payload	object	Дополнительные данные транзакции (например, signals).
manager	object	Менеджер, инициировавший транзакцию.
unitId/unit	number	ID юнита, связанного с транзакцией.
clientId	number	ID клиента, связанного с транзакцией.
invoiceId	number	ID инвойса, связанного с транзакцией.
exchangeId	number	ID обмена, если транзакция связана с обменом валют.
nativeRate	string	Курс валюты к основной валюте платформы.
usdtRate	string	Курс валюты к USDT.
annotation	string	Комментарий к транзакции.
subId	number	ID субсчета, если транзакция связана с субсчетом.
errorText	string	Текст ошибки, если транзакция не удалась.
change	string	Изменение баланса после транзакции.
remainingBalance	string	Остаток на кошельке после транзакции.
massPayoutId	number	ID массовой выплаты, если транзакция часть массового вывода.
category	object	Категория транзакции (группировка по типу операций).
walletFromName	string	Название кошелька отправителя.
walletToName	string	Название кошелька получателя.
riskScore	string	Уровень риска транзакции, оцененным АМЛ-провайдером.
externalId	string	ID любой, втутренней сущности для связи.

---