> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crypto-cash.world/llms.txt
> Use this file to discover all available pages before exploring further.

# Отримання списку транзакцій

> Повертає список транзакцій з пагінацією та фільтрацією



## OpenAPI

````yaml /APIs/crypto-cash-openapi-uk.json post /merchant/api/v1/balance/payments/list/
openapi: 3.1.0
info:
  title: CryptoCash Merchant API
  description: >-
    API для роботи з криптовалютними платежами. Усі запити потребують
    автентифікації через підпис. Тіло запиту містить: data (JSON-об'єкт у
    base64) та signature (SHA256(SECRET_KEY + data) у base64).
  version: 1.0.0
servers:
  - url: https://api.crypto-cash.world
    description: Production сервер
security: []
tags:
  - name: Balance
    description: Операції з балансом
  - name: Actions
    description: 'Дії: купівля, продаж, повернення'
  - name: Transactions
    description: Робота з транзакціями
  - name: Reference
    description: Довідкова інформація
externalDocs:
  description: Зовнішні курси валют
  url: https://rates.crypto-cash.world/api/v1/market/rates/export/json
paths:
  /merchant/api/v1/balance/payments/list/:
    post:
      tags:
        - Transactions
      summary: Отримання списку транзакцій
      description: Повертає список транзакцій з пагінацією та фільтрацією
      operationId: getPaymentsList
      requestBody:
        required: true
        description: |-
          Параметри даних:
          - **publicKey** (обов'язковий)
          - **page** (опціонально, за замовчуванням 1)
          - **pageSize** (опціонально, за замовчуванням 100)
          - **dateAfter** (опціонально)
          - **dateBefore** (опціонально)
          - **transactionType** (опціонально: buy|sale)
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SignedRequest'
        x-data-schema:
          $ref: '#/components/schemas/PaymentsListRequest'
      responses:
        '200':
          description: Успішна відповідь
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    example: 200
                  data:
                    type: object
                    properties:
                      items:
                        type: array
                        items:
                          $ref: '#/components/schemas/Transaction'
                      pagination:
                        $ref: '#/components/schemas/Pagination'
        '400':
          description: Помилка запиту
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    SignedRequest:
      type: object
      required:
        - data
        - signature
      properties:
        data:
          type: string
          description: JSON-об'єкт з параметрами запиту, закодований у base64
        signature:
          type: string
          description: Підпис SHA256(SECRET_KEY + data), закодований у base64
    Transaction:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Внутрішній ID транзакції
        pair:
          type: string
          description: Валютна пара
          example: USDT/USDT
        usdtTotal:
          type: string
          description: Загальна сума в USDT
        network:
          type: string
          description: Мережа
        hash:
          type: string
          description: Хеш транзакції
        amount:
          type: string
          description: Сума
        commission:
          type: string
          description: Комісія
        address:
          type: string
          description: Адреса
        exchangeRate:
          type: string
          description: Курс обміну
        networkFee:
          type: string
          description: Комісія мережі
        externalId:
          type: string
          description: Зовнішній ID
        transactionType:
          type: string
          enum:
            - Buy
            - Sale
          description: Тип транзакції
        createdAt:
          type: string
          format: date-time
          description: Дата створення
        updatedAt:
          type: string
          format: date-time
          description: Дата оновлення
        status:
          $ref: '#/components/schemas/TransactionStatus'
        balanceEntries:
          type: array
          items:
            $ref: '#/components/schemas/BalanceEntry'
    Pagination:
      type: object
      properties:
        page:
          type: integer
          description: Поточна сторінка
        total:
          type: integer
          description: Загальна кількість сторінок
        pageSize:
          type: integer
          description: Розмір сторінки
    Error:
      type: object
      properties:
        errors:
          type: array
          items:
            type: integer
          description: Список кодів помилок
      example:
        errors:
          - 1000
    TransactionStatus:
      type: string
      enum:
        - Queued
        - New
        - Waiting
        - Paid
        - Underpaid
        - Overpaid
        - Canceled
        - AMLFrozen
        - CurrencyMismatch
        - CanceledButPaid
        - CanceledButOverpaid
        - CanceledButUnderpaid
      description: Статус транзакції
    BalanceEntry:
      type: object
      properties:
        id:
          type: string
          format: uuid
        updatedAt:
          type: string
          format: date-time
        currency:
          type: string
        requestedCurrency:
          type: string
        exchangeRate:
          type: string
        requestedAmount:
          type: string
        feeAmount:
          type: string
        amount:
          type: string
        hash:
          type: string
        direction:
          type: string
          enum:
            - IN
            - OUT

````