---
title: "GET /payments"
method: GET
path: "/payments"
tags: ["Платежи"]
---

# GET /payments

`GET /payments`

Список платежей

## Query parameters

- `created_at.gte` string, date-time
- `created_at.gt` string, date-time
- `created_at.lte` string, date-time
- `created_at.lt` string, date-time
- `captured_at.gte` string, date-time
- `captured_at.gt` string, date-time
- `captured_at.lte` string, date-time
- `captured_at.lt` string, date-time
- `payment_method` 'bank_card' | 'cash' | 'alfabank' | 'webmoney' | 'wechat' | 'apple_pay' | 'google_pay' | 'qiwi' | 'installments' | 'yoo_money' | 'sberbank' | 'mobile_balance' | 'b2b_sberbank' | 'tinkoff_bank' | 'sbp' | 'sber_loan' | 'electronic_certificate' | 'sber_bnpl'
- `status` 'pending' | 'waiting_for_capture' | 'succeeded' | 'canceled'
- `limit` integer
- `cursor` string

## Response `200`

The request has succeeded.

- PaymentList
  - `type` string, required — Тип списка.
  - `items` Payment[], required — Список платежей.
    - `id` string, required
    - `status` 'pending' | 'waiting_for_capture' | 'succeeded' | 'canceled', required
    - `amount` MonetaryAmount, required
      - `value` string, required — Сумма в выбранной валюте. Выражается в виде строки и пишется через точку, например 10.00.
      - `currency` 'RUB' | 'EUR' | 'USD' | 'KZT' | 'BYN' | 'UAH' | 'UZS' | 'TRY' | 'INR' | 'MDL' | 'AZN' | 'AMD', required
    - `income_amount` MonetaryAmount
      - `value` string, required — Сумма в выбранной валюте. Выражается в виде строки и пишется через точку, например 10.00.
      - `currency` 'RUB' | 'EUR' | 'USD' | 'KZT' | 'BYN' | 'UAH' | 'UZS' | 'TRY' | 'INR' | 'MDL' | 'AZN' | 'AMD', required
    - `description` string
    - `recipient` Recipient, required
      - `gateway_id` string, required
    - `payment_method` union — Способ оплаты.
      - PaymentMethodBankCard
        - `type` 'bank_card' | 'cash' | 'alfabank' | 'webmoney' | 'wechat' | 'apple_pay' | 'google_pay' | 'qiwi' | 'installments' | 'yoo_money' | 'sberbank' | 'mobile_balance' | 'b2b_sberbank' | 'tinkoff_bank' | 'sbp' | 'sber_loan' | 'electronic_certificate' | 'sber_bnpl', required
        - `id` string, required
        - `saved` boolean, required — Признак сохранения платежных данных.
        - `status` 'pending' | 'active' | 'inactive', required
        - `title` string — Название способа оплаты.
      - PaymentMethodCash
        - `type` 'bank_card' | 'cash' | 'alfabank' | 'webmoney' | 'wechat' | 'apple_pay' | 'google_pay' | 'qiwi' | 'installments' | 'yoo_money' | 'sberbank' | 'mobile_balance' | 'b2b_sberbank' | 'tinkoff_bank' | 'sbp' | 'sber_loan' | 'electronic_certificate' | 'sber_bnpl', required
        - `id` string, required
        - `saved` boolean, required — Признак сохранения платежных данных.
        - `status` 'pending' | 'active' | 'inactive', required
        - `title` string — Название способа оплаты.
      - PaymentMethodQiwi
        - `type` 'bank_card' | 'cash' | 'alfabank' | 'webmoney' | 'wechat' | 'apple_pay' | 'google_pay' | 'qiwi' | 'installments' | 'yoo_money' | 'sberbank' | 'mobile_balance' | 'b2b_sberbank' | 'tinkoff_bank' | 'sbp' | 'sber_loan' | 'electronic_certificate' | 'sber_bnpl', required
        - `id` string, required
        - `saved` boolean, required — Признак сохранения платежных данных.
        - `status` 'pending' | 'active' | 'inactive', required
        - `title` string — Название способа оплаты.
      - PaymentMethodAlfabank
        - `type` 'bank_card' | 'cash' | 'alfabank' | 'webmoney' | 'wechat' | 'apple_pay' | 'google_pay' | 'qiwi' | 'installments' | 'yoo_money' | 'sberbank' | 'mobile_balance' | 'b2b_sberbank' | 'tinkoff_bank' | 'sbp' | 'sber_loan' | 'electronic_certificate' | 'sber_bnpl', required
        - `id` string, required
        - `saved` boolean, required — Признак сохранения платежных данных.
        - `status` 'pending' | 'active' | 'inactive', required
        - `title` string — Название способа оплаты.
      - PaymentMethodWebmoney
        - `type` 'bank_card' | 'cash' | 'alfabank' | 'webmoney' | 'wechat' | 'apple_pay' | 'google_pay' | 'qiwi' | 'installments' | 'yoo_money' | 'sberbank' | 'mobile_balance' | 'b2b_sberbank' | 'tinkoff_bank' | 'sbp' | 'sber_loan' | 'electronic_certificate' | 'sber_bnpl', required
        - `id` string, required
        - `saved` boolean, required — Признак сохранения платежных данных.
        - `status` 'pending' | 'active' | 'inactive', required
        - `title` string — Название способа оплаты.
      - PaymentMethodSberbank
        - `type` 'bank_card' | 'cash' | 'alfabank' | 'webmoney' | 'wechat' | 'apple_pay' | 'google_pay' | 'qiwi' | 'installments' | 'yoo_money' | 'sberbank' | 'mobile_balance' | 'b2b_sberbank' | 'tinkoff_bank' | 'sbp' | 'sber_loan' | 'electronic_certificate' | 'sber_bnpl', required
        - `id` string, required
        - `saved` boolean, required — Признак сохранения платежных данных.
        - `status` 'pending' | 'active' | 'inactive', required
        - `title` string — Название способа оплаты.
      - PaymentMethodTinkoffBank
        - `type` 'bank_card' | 'cash' | 'alfabank' | 'webmoney' | 'wechat' | 'apple_pay' | 'google_pay' | 'qiwi' | 'installments' | 'yoo_money' | 'sberbank' | 'mobile_balance' | 'b2b_sberbank' | 'tinkoff_bank' | 'sbp' | 'sber_loan' | 'electronic_certificate' | 'sber_bnpl', required
        - `id` string, required
        - `saved` boolean, required — Признак сохранения платежных данных.
        - `status` 'pending' | 'active' | 'inactive', required
        - `title` string — Название способа оплаты.
      - PaymentMethodYooMoney
        - `type` 'bank_card' | 'cash' | 'alfabank' | 'webmoney' | 'wechat' | 'apple_pay' | 'google_pay' | 'qiwi' | 'installments' | 'yoo_money' | 'sberbank' | 'mobile_balance' | 'b2b_sberbank' | 'tinkoff_bank' | 'sbp' | 'sber_loan' | 'electronic_certificate' | 'sber_bnpl', required
        - `id` string, required
        - `saved` boolean, required — Признак сохранения платежных данных.
        - `status` 'pending' | 'active' | 'inactive', required
        - `title` string — Название способа оплаты.
      - PaymentMethodApplePay
        - `type` 'bank_card' | 'cash' | 'alfabank' | 'webmoney' | 'wechat' | 'apple_pay' | 'google_pay' | 'qiwi' | 'installments' | 'yoo_money' | 'sberbank' | 'mobile_balance' | 'b2b_sberbank' | 'tinkoff_bank' | 'sbp' | 'sber_loan' | 'electronic_certificate' | 'sber_bnpl', required
        - `id` string, required
        - `saved` boolean, required — Признак сохранения платежных данных.
        - `status` 'pending' | 'active' | 'inactive', required
        - `title` string — Название способа оплаты.
      - PaymentMethodGooglePay
        - `type` 'bank_card' | 'cash' | 'alfabank' | 'webmoney' | 'wechat' | 'apple_pay' | 'google_pay' | 'qiwi' | 'installments' | 'yoo_money' | 'sberbank' | 'mobile_balance' | 'b2b_sberbank' | 'tinkoff_bank' | 'sbp' | 'sber_loan' | 'electronic_certificate' | 'sber_bnpl', required
        - `id` string, required
        - `saved` boolean, required — Признак сохранения платежных данных.
        - `status` 'pending' | 'active' | 'inactive', required
        - `title` string — Название способа оплаты.
      - PaymentMethodMobileBalance
        - `type` 'bank_card' | 'cash' | 'alfabank' | 'webmoney' | 'wechat' | 'apple_pay' | 'google_pay' | 'qiwi' | 'installments' | 'yoo_money' | 'sberbank' | 'mobile_balance' | 'b2b_sberbank' | 'tinkoff_bank' | 'sbp' | 'sber_loan' | 'electronic_certificate' | 'sber_bnpl', required
        - `id` string, required
        - `saved` boolean, required — Признак сохранения платежных данных.
        - `status` 'pending' | 'active' | 'inactive', required
        - `title` string — Название способа оплаты.
      - PaymentMethodInstallments
        - `type` 'bank_card' | 'cash' | 'alfabank' | 'webmoney' | 'wechat' | 'apple_pay' | 'google_pay' | 'qiwi' | 'installments' | 'yoo_money' | 'sberbank' | 'mobile_balance' | 'b2b_sberbank' | 'tinkoff_bank' | 'sbp' | 'sber_loan' | 'electronic_certificate' | 'sber_bnpl', required
        - `id` string, required
        - `saved` boolean, required — Признак сохранения платежных данных.
        - `status` 'pending' | 'active' | 'inactive', required
        - `title` string — Название способа оплаты.
      - PaymentMethodB2bSberbank
        - `type` 'bank_card' | 'cash' | 'alfabank' | 'webmoney' | 'wechat' | 'apple_pay' | 'google_pay' | 'qiwi' | 'installments' | 'yoo_money' | 'sberbank' | 'mobile_balance' | 'b2b_sberbank' | 'tinkoff_bank' | 'sbp' | 'sber_loan' | 'electronic_certificate' | 'sber_bnpl', required
        - `id` string, required
        - `saved` boolean, required — Признак сохранения платежных данных.
        - `status` 'pending' | 'active' | 'inactive', required
        - `title` string — Название способа оплаты.
      - PaymentMethodWeChat
        - `type` 'bank_card' | 'cash' | 'alfabank' | 'webmoney' | 'wechat' | 'apple_pay' | 'google_pay' | 'qiwi' | 'installments' | 'yoo_money' | 'sberbank' | 'mobile_balance' | 'b2b_sberbank' | 'tinkoff_bank' | 'sbp' | 'sber_loan' | 'electronic_certificate' | 'sber_bnpl', required
        - `id` string, required
        - `saved` boolean, required — Признак сохранения платежных данных.
        - `status` 'pending' | 'active' | 'inactive', required
        - `title` string — Название способа оплаты.
      - PaymentMethodSbp
        - `type` 'bank_card' | 'cash' | 'alfabank' | 'webmoney' | 'wechat' | 'apple_pay' | 'google_pay' | 'qiwi' | 'installments' | 'yoo_money' | 'sberbank' | 'mobile_balance' | 'b2b_sberbank' | 'tinkoff_bank' | 'sbp' | 'sber_loan' | 'electronic_certificate' | 'sber_bnpl', required
        - `id` string, required
        - `saved` boolean, required — Признак сохранения платежных данных.
        - `status` 'pending' | 'active' | 'inactive', required
        - `title` string — Название способа оплаты.
      - PaymentMethodSberLoan
        - `type` 'bank_card' | 'cash' | 'alfabank' | 'webmoney' | 'wechat' | 'apple_pay' | 'google_pay' | 'qiwi' | 'installments' | 'yoo_money' | 'sberbank' | 'mobile_balance' | 'b2b_sberbank' | 'tinkoff_bank' | 'sbp' | 'sber_loan' | 'electronic_certificate' | 'sber_bnpl', required
        - `id` string, required
        - `saved` boolean, required — Признак сохранения платежных данных.
        - `status` 'pending' | 'active' | 'inactive', required
        - `title` string — Название способа оплаты.
      - PaymentMethodElectronicCertificate
        - `type` 'bank_card' | 'cash' | 'alfabank' | 'webmoney' | 'wechat' | 'apple_pay' | 'google_pay' | 'qiwi' | 'installments' | 'yoo_money' | 'sberbank' | 'mobile_balance' | 'b2b_sberbank' | 'tinkoff_bank' | 'sbp' | 'sber_loan' | 'electronic_certificate' | 'sber_bnpl', required
        - `id` string, required
        - `saved` boolean, required — Признак сохранения платежных данных.
        - `status` 'pending' | 'active' | 'inactive', required
        - `title` string — Название способа оплаты.
      - PaymentMethodSberBnpl
        - `type` 'bank_card' | 'cash' | 'alfabank' | 'webmoney' | 'wechat' | 'apple_pay' | 'google_pay' | 'qiwi' | 'installments' | 'yoo_money' | 'sberbank' | 'mobile_balance' | 'b2b_sberbank' | 'tinkoff_bank' | 'sbp' | 'sber_loan' | 'electronic_certificate' | 'sber_bnpl', required
        - `id` string, required
        - `saved` boolean, required — Признак сохранения платежных данных.
        - `status` 'pending' | 'active' | 'inactive', required
        - `title` string — Название способа оплаты.
    - `captured_at` string, date-time — Время подтверждения платежа.
    - `created_at` string, date-time, required — Время создания заказа.
    - `expires_at` string, date-time — Время, до которого вы можете бесплатно отменить или подтвердить платеж.
    - `confirmation` union — Выбранный способ подтверждения платежа.
      - ConfirmationRedirect
        - `type` 'redirect' | 'external' | 'qr' | 'embedded' | 'mobile_application', required
      - ConfirmationExternal
        - `type` 'redirect' | 'external' | 'qr' | 'embedded' | 'mobile_application', required
      - ConfirmationQr
        - `type` 'redirect' | 'external' | 'qr' | 'embedded' | 'mobile_application', required
      - ConfirmationEmbedded
        - `type` 'redirect' | 'external' | 'qr' | 'embedded' | 'mobile_application', required
      - ConfirmationMobileApplication
        - `type` 'redirect' | 'external' | 'qr' | 'embedded' | 'mobile_application', required
    - `test` boolean, required — Признак тестовой операции.
    - `refunded_amount` MonetaryAmount
      - `value` string, required — Сумма в выбранной валюте. Выражается в виде строки и пишется через точку, например 10.00.
      - `currency` 'RUB' | 'EUR' | 'USD' | 'KZT' | 'BYN' | 'UAH' | 'UZS' | 'TRY' | 'INR' | 'MDL' | 'AZN' | 'AMD', required
    - `paid` boolean, required — Признак оплаты заказа.
    - `refundable` boolean, required — Возможность провести возврат по API.
    - `receipt_registration` 'pending' | 'succeeded' | 'canceled'
    - `metadata` Metadata — Любые дополнительные данные, которые нужны вам для работы (например, номер заказа). Передаются в виде набора пар «ключ-значение» и возвращаются в ответе от ЮKassa. Ограничения: максимум 16 ключей, имя ключа не больше 32 символов, значение ключа не больше 512 символов, тип данных — строка в формате UTF-8.
    - `cancellation_details` PaymentCancellationDetails
      - `party` string, required — Участник процесса платежа, принявший решение об отмене.
      - `reason` string, required — Причина отмены платежа.
    - `authorization_details` AuthorizationDetails
      - `rrn` string
      - `auth_code` string
      - `three_d_secure` ThreeDSecureDetails, required
        - `applied` boolean, required — Отображает, была ли пройдена аутентификация по 3-D Secure.
    - `transfers` Transfer[] — Данные о распределении денег.
      - `account_id` string, required
      - `amount` MonetaryAmount, required
        - `value` string, required — Сумма в выбранной валюте. Выражается в виде строки и пишется через точку, например 10.00.
        - `currency` 'RUB' | 'EUR' | 'USD' | 'KZT' | 'BYN' | 'UAH' | 'UZS' | 'TRY' | 'INR' | 'MDL' | 'AZN' | 'AMD', required
      - `status` 'pending' | 'waiting_for_capture' | 'succeeded' | 'canceled', required
      - `platform_fee_amount` MonetaryAmount
        - `value` string, required — Сумма в выбранной валюте. Выражается в виде строки и пишется через точку, например 10.00.
        - `currency` 'RUB' | 'EUR' | 'USD' | 'KZT' | 'BYN' | 'UAH' | 'UZS' | 'TRY' | 'INR' | 'MDL' | 'AZN' | 'AMD', required
      - `description` string — Описание транзакции.
      - `metadata` Metadata — Любые дополнительные данные, которые нужны вам для работы (например, номер заказа). Передаются в виде набора пар «ключ-значение» и возвращаются в ответе от ЮKassa. Ограничения: максимум 16 ключей, имя ключа не больше 32 символов, значение ключа не больше 512 символов, тип данных — строка в формате UTF-8.
    - `deal` PaymentDealInfo
      - `id` string, required
      - `settlements` SettlementPaymentItem[], required — Данные о распределении денег.
        - `type` 'payout', required
        - `amount` MonetaryAmount, required
          - `value` string, required — Сумма в выбранной валюте. Выражается в виде строки и пишется через точку, например 10.00.
          - `currency` 'RUB' | 'EUR' | 'USD' | 'KZT' | 'BYN' | 'UAH' | 'UZS' | 'TRY' | 'INR' | 'MDL' | 'AZN' | 'AMD', required
    - `merchant_customer_id` string
    - `invoice_details` string — Данные о счете, который оплачивается.
  - `next_cursor` string

## Other responses

- `400` — The server could not understand the request due to invalid syntax.
- `401` — Access is unauthorized.
- `403` — Access is forbidden.
- `500` — Server error

## Changes

- **2026-02-14** `fe24d3dfadad` — 28 breaking, 3 warning, 111 info
  - for the `query` request parameter `limit`, the type/format was changed from `integer`/`` to `integer`/`int32`
  - the `items/items/deal/allOf[#/components/schemas/PaymentDealInfo]/id` response property's maxLength was unset from `50` for the response status `200`
  - the `items/items/description/allOf[#/components/schemas/Description]/` response property's maxLength was unset from `128` for the response status `200`
  - the `items/items/id` response property's maxLength was unset from `36` for the response status `200`
  - …138 more

[Change history](https://skmtc.dev/hexlet/apis/api-kassa/changes/payments/get.md)

---

[API](https://skmtc.dev/hexlet/apis/api-kassa.md) · [All operations](https://skmtc.dev/hexlet/apis/api-kassa/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hexlet/api-kassa/revisions/f35dc69c1c37/schema)