Transaction Detail

GET /api/transactions/{uuid}

⚷ Bearer Token

Полные данные одной операции

Возвращает расширенный объект транзакции — включая историю статусов, blockchain-метаданные, ссылки на explorer и связанные сущности (OTC-сделка, торговый ордер, KYC-вердикт).

Path parameters

Name	Type	Required	Description
`uuid`	`string (uuid)`	required	UUID транзакции — из списка `GET /api/transactions` или из webhook payload.

Response

Responses

{
  "data": {
    "id": "tx_5f8d7a3c-1234-4567-89ab-cdef01234567",
    "type": "withdraw",
    "status": "completed",
    "amount": "50.000000",
    "currency": "USDT",
    "network": "TRC20",
    "amount_rub": "4875.00",
    "fee": "1.000000",
    "fee_currency": "USDT",
    "fee_rub": "97.50",
    "tx_hash": "0xdef456...",
    "from_address": "TYourSourceAddress...",
    "to_address": "TRecipientAddress...",
    "confirmations": 25,
    "required_confirmations": 1,
    "created_at": "2026-05-27T14:23:00Z",
    "completed_at": "2026-05-27T14:25:30Z",
    "description": "Withdrawal to cold storage",
    "external_id": "user-supplied-ref-12345",
    "history": [
      { "status": "pending",     "at": "2026-05-27T14:23:00Z" },
      { "status": "broadcasting","at": "2026-05-27T14:23:45Z" },
      { "status": "confirming",  "at": "2026-05-27T14:24:10Z", "confirmations": 0 },
      { "status": "completed",   "at": "2026-05-27T14:25:30Z", "confirmations": 1 }
    ],
    "compliance": {
      "aml_score": 12,
      "aml_risk": "low",
      "sanctions_check": "clear"
    },
    "related": {
      "order_id": null,
      "otc_deal_id": null,
      "exchange_id": null
    },
    "links": {
      "explorer": "https://tronscan.org/#/transaction/0xdef...",
      "receipt_pdf": "https://fin-os.io/api/transactions/tx_5f8d.../receipt.pdf"
    }
  }
}

{
  "message": "Transaction not found.",
  "error_code": "RESOURCE_NOT_FOUND"
}

{
  "message": "This transaction belongs to another user.",
  "error_code": "FORBIDDEN"
}

PDF Receipt

Поле links.receipt_pdf — это endpoint GET /api/transactions/{uuid}/receipt.pdf, возвращающий бухгалтерский PDF-чек с печатью и QR-кодом для верификации. Полезно для отчётности и налоговой.

✦

Receipt для НДФЛ

Для подачи декларации в РФ удобнее использовать POST /api/tax-reports/generate — собирает все операции за период в одном Excel/PDF документе, готовом к подаче.