--- title: "Список платежей" method: GET path: "/payments" tags: ["Платежи"] --- # Список платежей `GET /payments` Используйте этот запрос, чтобы получить список платежей. Для выгрузки доступны платежи, созданные за последние 3 года. Список можно отфильтровать по различным критериям. Подробнее о работе со списками: https://yookassa.ru/developers/using-api/lists ## 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' — Код способа оплаты — тип платежного средства, которое используется для оплаты. Подробнее о способах оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods - `status` 'pending' | 'waiting_for_capture' | 'succeeded' | 'canceled' — Статус платежа. Возможные значения: pending, waiting_for_capture, succeeded и canceled. Подробнее про жизненный цикл платежа: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-process#lifecycle - `limit` integer - `cursor` string ## Response `200` Запрос успешно обработан - PaymentList — Список платежей. Платежи отсортированы по времени создания в порядке убывания (от новых к старым). Если результатов больше, чем задано в limit, список будет выводиться фрагментами. В этом случае в ответе на запрос вернется фрагмент списка и параметр next_cursor с указателем на следующий фрагмент. - `type` 'list', required — Формат выдачи результатов запроса. Возможное значение: list (список). - `items` Payment[], required - `id` string, required — Идентификатор платежа в ЮKassa. - `status` 'pending' | 'waiting_for_capture' | 'succeeded' | 'canceled', required — Статус платежа. Возможные значения: pending, waiting_for_capture, succeeded и canceled. Подробнее про жизненный цикл платежа: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-process#lifecycle - `amount` object, required — Сумма платежа. Иногда партнеры ЮKassa берут с пользователя дополнительную комиссию, которая не входит в эту сумму. Сумма указывается с кодом валюты. Если вы разделяете потоки платежей, валюта платежа должна соответствовать валюте субаккаунта (recipient.gateway_id), если не разделяете — валюте аккаунта shopId в личном кабинете). - `value` string, required — Сумма в выбранной валюте. Всегда дробное значение. Разделитель дробной части — точка, разделитель тысяч отсутствует. Количество знаков после точки зависит от выбранной валюты. Пример: 1000.00. - `currency` 'RUB' | 'EUR' | 'USD' | 'KZT' | 'BYN' | 'UAH' | 'UZS' | 'TRY' | 'INR' | 'MDL' | 'AZN' | 'AMD', required — Трехбуквенный код валюты в формате ISO-4217: https://www.iso.org/iso-4217-currency-codes.html. Пример: RUB. - `income_amount` object — Сумма платежа, которую получит магазин, — значение amount за вычетом комиссии ЮKassa и суммы НДС с этой комиссии. Если вы партнер: https://yookassa.ru/developers/solutions-for-platforms/partners-api/basics и для аутентификации запросов используете OAuth-токен, запросите у магазина право: https://yookassa.ru/developers/solutions-for-platforms/partners-api/oauth/basics на получение информации о комиссиях при платежах. - `value` string, required — Сумма в выбранной валюте. Всегда дробное значение. Разделитель дробной части — точка, разделитель тысяч отсутствует. Количество знаков после точки зависит от выбранной валюты. Пример: 1000.00. - `currency` 'RUB' | 'EUR' | 'USD' | 'KZT' | 'BYN' | 'UAH' | 'UZS' | 'TRY' | 'INR' | 'MDL' | 'AZN' | 'AMD', required — Трехбуквенный код валюты в формате ISO-4217: https://www.iso.org/iso-4217-currency-codes.html. Пример: RUB. - `description` string — Описание транзакции (не более 128 символов), которое вы увидите в личном кабинете ЮKassa, а пользователь — при оплате. Например: «Оплата заказа № 72 для user@yoomoney.ru». - `recipient` object, required — Получатель платежа. - `account_id` string, required — Идентификатор магазина в ЮKassa. - `gateway_id` string, required — Идентификатор субаккаунта. Используется для разделения потоков платежей в рамках одного аккаунта. - `payment_method` union - PaymentMethodBankCard — Способ оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods#all, который был использован для этого платежа. - `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 — Код способа оплаты — тип платежного средства, которое используется для оплаты. Подробнее о способах оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods - `id` string, required — Идентификатор способа оплаты. - `saved` boolean, required — Признак сохранения способа оплаты для автоплатежей: https://yookassa.ru/developers/payment-acceptance/scenario-extensions/recurring-payments/pay-with-saved. Возможные значения: true — способ оплаты сохранен для автоплатежей и выплат; false — способ оплаты не сохранен. - `status` 'pending' | 'active' | 'inactive', required — Статус проверки и сохранения способа оплаты. Возможные значения: pending — ожидает действий от пользователя; active — способ оплаты сохранен, его можно использовать для автоплатежей или выплат; inactive — способ оплаты не сохранен: возникла ошибка или не было попытки сохранения способа оплаты. - `title` string — Название способа оплаты. - `card` BankCardData — Данные банковской карты. - `first6` string — Первые 6 цифр номера карты (BIN). При оплате картой, сохраненной в ЮKassa: https://yookassa.ru/developers/payment-acceptance/scenario-extensions/recurring-payments/basics и других сервисах, переданный BIN может не соответствовать значениям last4, expiry_year, expiry_month. - `last4` string, required — Последние 4 цифры номера карты. - `expiry_year` string, required — Срок действия, год, YYYY. - `expiry_month` string, required — Срок действия, месяц, MM. - `card_type` 'MasterCard' | 'Visa' | 'Mir' | 'UnionPay' | 'JCB' | 'AmericanExpress' | 'DinersClub' | 'DiscoverCard' | 'InstaPayment' | 'InstaPaymentTM' | 'Laser' | 'Dankort' | 'Solo' | 'Switch' | 'Unknown', required — Тип банковской карты. Возможные значения: MasterCard (для карт Mastercard и Maestro), Visa (для карт Visa и Visa Electron), Mir, UnionPay, JCB, AmericanExpress, DinersClub, DiscoverCard, InstaPayment, InstaPaymentTM, Laser, Dankort, Solo, Switch и Unknown. - `card_product` BankCardProduct — Карточный продукт платежной системы, с которым ассоциирована банковская карта. Например, карточные продукты платежной системы Мир: Mir Classic, Mir Classic Credit, MIR Privilege Plus и другие. - `code` string, required — Код карточного продукта. Пример: MCP - `name` string — Название карточного продукта. Пример: MIR Privilege - `issuer_country` string — Код страны, в которой выпущена карта. Передается в формате ISO-3166 alpha-2: https://www.iso.org/obp/ui/#iso:pub:PUB500001:en. Пример: RU. - `issuer_name` string — Наименование банка, выпустившего карту. - `source` 'apple_pay' | 'google_pay' | 'mir_pay' — Источник данных банковской карты. Возможные значения: mir_pay, apple_pay, google_pay. Присутствует, если пользователь при оплате выбрал карту, сохраненную в Mir Pay, Apple Pay или Google Pay. - PaymentMethodCash — Способ оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods#all, который был использован для этого платежа. - `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 — Код способа оплаты — тип платежного средства, которое используется для оплаты. Подробнее о способах оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods - `id` string, required — Идентификатор способа оплаты. - `saved` boolean, required — Признак сохранения способа оплаты для автоплатежей: https://yookassa.ru/developers/payment-acceptance/scenario-extensions/recurring-payments/pay-with-saved. Возможные значения: true — способ оплаты сохранен для автоплатежей и выплат; false — способ оплаты не сохранен. - `status` 'pending' | 'active' | 'inactive', required — Статус проверки и сохранения способа оплаты. Возможные значения: pending — ожидает действий от пользователя; active — способ оплаты сохранен, его можно использовать для автоплатежей или выплат; inactive — способ оплаты не сохранен: возникла ошибка или не было попытки сохранения способа оплаты. - `title` string — Название способа оплаты. - PaymentMethodQiwi — Способ оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods#all, который был использован для этого платежа. - `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 — Код способа оплаты — тип платежного средства, которое используется для оплаты. Подробнее о способах оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods - `id` string, required — Идентификатор способа оплаты. - `saved` boolean, required — Признак сохранения способа оплаты для автоплатежей: https://yookassa.ru/developers/payment-acceptance/scenario-extensions/recurring-payments/pay-with-saved. Возможные значения: true — способ оплаты сохранен для автоплатежей и выплат; false — способ оплаты не сохранен. - `status` 'pending' | 'active' | 'inactive', required — Статус проверки и сохранения способа оплаты. Возможные значения: pending — ожидает действий от пользователя; active — способ оплаты сохранен, его можно использовать для автоплатежей или выплат; inactive — способ оплаты не сохранен: возникла ошибка или не было попытки сохранения способа оплаты. - `title` string — Название способа оплаты. - PaymentMethodAlfabank — Способ оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods#all, который был использован для этого платежа. - `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 — Код способа оплаты — тип платежного средства, которое используется для оплаты. Подробнее о способах оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods - `id` string, required — Идентификатор способа оплаты. - `saved` boolean, required — Признак сохранения способа оплаты для автоплатежей: https://yookassa.ru/developers/payment-acceptance/scenario-extensions/recurring-payments/pay-with-saved. Возможные значения: true — способ оплаты сохранен для автоплатежей и выплат; false — способ оплаты не сохранен. - `status` 'pending' | 'active' | 'inactive', required — Статус проверки и сохранения способа оплаты. Возможные значения: pending — ожидает действий от пользователя; active — способ оплаты сохранен, его можно использовать для автоплатежей или выплат; inactive — способ оплаты не сохранен: возникла ошибка или не было попытки сохранения способа оплаты. - `title` string — Название способа оплаты. - `login` string — Логин пользователя в Альфа-Клике (привязанный телефон или дополнительный логин). - PaymentMethodWebmoney — Способ оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods#all, который был использован для этого платежа. - `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 — Код способа оплаты — тип платежного средства, которое используется для оплаты. Подробнее о способах оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods - `id` string, required — Идентификатор способа оплаты. - `saved` boolean, required — Признак сохранения способа оплаты для автоплатежей: https://yookassa.ru/developers/payment-acceptance/scenario-extensions/recurring-payments/pay-with-saved. Возможные значения: true — способ оплаты сохранен для автоплатежей и выплат; false — способ оплаты не сохранен. - `status` 'pending' | 'active' | 'inactive', required — Статус проверки и сохранения способа оплаты. Возможные значения: pending — ожидает действий от пользователя; active — способ оплаты сохранен, его можно использовать для автоплатежей или выплат; inactive — способ оплаты не сохранен: возникла ошибка или не было попытки сохранения способа оплаты. - `title` string — Название способа оплаты. - PaymentMethodSberbank — Способ оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods#all, который был использован для этого платежа. - `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 — Код способа оплаты — тип платежного средства, которое используется для оплаты. Подробнее о способах оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods - `id` string, required — Идентификатор способа оплаты. - `saved` boolean, required — Признак сохранения способа оплаты для автоплатежей: https://yookassa.ru/developers/payment-acceptance/scenario-extensions/recurring-payments/pay-with-saved. Возможные значения: true — способ оплаты сохранен для автоплатежей и выплат; false — способ оплаты не сохранен. - `status` 'pending' | 'active' | 'inactive', required — Статус проверки и сохранения способа оплаты. Возможные значения: pending — ожидает действий от пользователя; active — способ оплаты сохранен, его можно использовать для автоплатежей или выплат; inactive — способ оплаты не сохранен: возникла ошибка или не было попытки сохранения способа оплаты. - `title` string — Название способа оплаты. - `phone` string — Телефон пользователя, на который зарегистрирован аккаунт в SberPay. Указывается в формате ITU-T E.164: https://ru.wikipedia.org/wiki/E.164, например 79000000000. - `card` InvoicingBankCardData — Данные банковской карты. - `first6` string, required — Первые 6 цифр номера карты (BIN). - `last4` string, required — Последние 4 цифры номера карты. - `expiry_year` string, required — Срок действия, год, YYYY. - `expiry_month` string, required — Срок действия, месяц, MM. - `card_type` 'MasterCard' | 'Visa' | 'Mir' | 'UnionPay' | 'JCB' | 'AmericanExpress' | 'DinersClub' | 'DiscoverCard' | 'InstaPayment' | 'InstaPaymentTM' | 'Laser' | 'Dankort' | 'Solo' | 'Switch' | 'Unknown', required — Тип банковской карты. Возможные значения: MasterCard (для карт Mastercard и Maestro), Visa (для карт Visa и Visa Electron), Mir, UnionPay, JCB, AmericanExpress, DinersClub, DiscoverCard, InstaPayment, InstaPaymentTM, Laser, Dankort, Solo, Switch и Unknown. - PaymentMethodTinkoffBank — Способ оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods#all, который был использован для этого платежа. - `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 — Код способа оплаты — тип платежного средства, которое используется для оплаты. Подробнее о способах оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods - `id` string, required — Идентификатор способа оплаты. - `saved` boolean, required — Признак сохранения способа оплаты для автоплатежей: https://yookassa.ru/developers/payment-acceptance/scenario-extensions/recurring-payments/pay-with-saved. Возможные значения: true — способ оплаты сохранен для автоплатежей и выплат; false — способ оплаты не сохранен. - `status` 'pending' | 'active' | 'inactive', required — Статус проверки и сохранения способа оплаты. Возможные значения: pending — ожидает действий от пользователя; active — способ оплаты сохранен, его можно использовать для автоплатежей или выплат; inactive — способ оплаты не сохранен: возникла ошибка или не было попытки сохранения способа оплаты. - `title` string — Название способа оплаты. - `card` InvoicingBankCardData — Данные банковской карты. - `first6` string, required — Первые 6 цифр номера карты (BIN). - `last4` string, required — Последние 4 цифры номера карты. - `expiry_year` string, required — Срок действия, год, YYYY. - `expiry_month` string, required — Срок действия, месяц, MM. - `card_type` 'MasterCard' | 'Visa' | 'Mir' | 'UnionPay' | 'JCB' | 'AmericanExpress' | 'DinersClub' | 'DiscoverCard' | 'InstaPayment' | 'InstaPaymentTM' | 'Laser' | 'Dankort' | 'Solo' | 'Switch' | 'Unknown', required — Тип банковской карты. Возможные значения: MasterCard (для карт Mastercard и Maestro), Visa (для карт Visa и Visa Electron), Mir, UnionPay, JCB, AmericanExpress, DinersClub, DiscoverCard, InstaPayment, InstaPaymentTM, Laser, Dankort, Solo, Switch и Unknown. - PaymentMethodYooMoney — Способ оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods#all, который был использован для этого платежа. - `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 — Код способа оплаты — тип платежного средства, которое используется для оплаты. Подробнее о способах оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods - `id` string, required — Идентификатор способа оплаты. - `saved` boolean, required — Признак сохранения способа оплаты для автоплатежей: https://yookassa.ru/developers/payment-acceptance/scenario-extensions/recurring-payments/pay-with-saved. Возможные значения: true — способ оплаты сохранен для автоплатежей и выплат; false — способ оплаты не сохранен. - `status` 'pending' | 'active' | 'inactive', required — Статус проверки и сохранения способа оплаты. Возможные значения: pending — ожидает действий от пользователя; active — способ оплаты сохранен, его можно использовать для автоплатежей или выплат; inactive — способ оплаты не сохранен: возникла ошибка или не было попытки сохранения способа оплаты. - `title` string — Название способа оплаты. - `account_number` string — Номер кошелька ЮMoney, из которого заплатил пользователь. - PaymentMethodApplePay — Способ оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods#all, который был использован для этого платежа. - `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 — Код способа оплаты — тип платежного средства, которое используется для оплаты. Подробнее о способах оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods - `id` string, required — Идентификатор способа оплаты. - `saved` boolean, required — Признак сохранения способа оплаты для автоплатежей: https://yookassa.ru/developers/payment-acceptance/scenario-extensions/recurring-payments/pay-with-saved. Возможные значения: true — способ оплаты сохранен для автоплатежей и выплат; false — способ оплаты не сохранен. - `status` 'pending' | 'active' | 'inactive', required — Статус проверки и сохранения способа оплаты. Возможные значения: pending — ожидает действий от пользователя; active — способ оплаты сохранен, его можно использовать для автоплатежей или выплат; inactive — способ оплаты не сохранен: возникла ошибка или не было попытки сохранения способа оплаты. - `title` string — Название способа оплаты. - PaymentMethodGooglePay — Способ оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods#all, который был использован для этого платежа. - `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 — Код способа оплаты — тип платежного средства, которое используется для оплаты. Подробнее о способах оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods - `id` string, required — Идентификатор способа оплаты. - `saved` boolean, required — Признак сохранения способа оплаты для автоплатежей: https://yookassa.ru/developers/payment-acceptance/scenario-extensions/recurring-payments/pay-with-saved. Возможные значения: true — способ оплаты сохранен для автоплатежей и выплат; false — способ оплаты не сохранен. - `status` 'pending' | 'active' | 'inactive', required — Статус проверки и сохранения способа оплаты. Возможные значения: pending — ожидает действий от пользователя; active — способ оплаты сохранен, его можно использовать для автоплатежей или выплат; inactive — способ оплаты не сохранен: возникла ошибка или не было попытки сохранения способа оплаты. - `title` string — Название способа оплаты. - PaymentMethodMobileBalance — Способ оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods#all, который был использован для этого платежа. - `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 — Код способа оплаты — тип платежного средства, которое используется для оплаты. Подробнее о способах оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods - `id` string, required — Идентификатор способа оплаты. - `saved` boolean, required — Признак сохранения способа оплаты для автоплатежей: https://yookassa.ru/developers/payment-acceptance/scenario-extensions/recurring-payments/pay-with-saved. Возможные значения: true — способ оплаты сохранен для автоплатежей и выплат; false — способ оплаты не сохранен. - `status` 'pending' | 'active' | 'inactive', required — Статус проверки и сохранения способа оплаты. Возможные значения: pending — ожидает действий от пользователя; active — способ оплаты сохранен, его можно использовать для автоплатежей или выплат; inactive — способ оплаты не сохранен: возникла ошибка или не было попытки сохранения способа оплаты. - `title` string — Название способа оплаты. - PaymentMethodInstallments — Способ оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods#all, который был использован для этого платежа. - `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 — Код способа оплаты — тип платежного средства, которое используется для оплаты. Подробнее о способах оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods - `id` string, required — Идентификатор способа оплаты. - `saved` boolean, required — Признак сохранения способа оплаты для автоплатежей: https://yookassa.ru/developers/payment-acceptance/scenario-extensions/recurring-payments/pay-with-saved. Возможные значения: true — способ оплаты сохранен для автоплатежей и выплат; false — способ оплаты не сохранен. - `status` 'pending' | 'active' | 'inactive', required — Статус проверки и сохранения способа оплаты. Возможные значения: pending — ожидает действий от пользователя; active — способ оплаты сохранен, его можно использовать для автоплатежей или выплат; inactive — способ оплаты не сохранен: возникла ошибка или не было попытки сохранения способа оплаты. - `title` string — Название способа оплаты. - PaymentMethodB2bSberbank — Способ оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods#all, который был использован для этого платежа. - `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 — Код способа оплаты — тип платежного средства, которое используется для оплаты. Подробнее о способах оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods - `id` string, required — Идентификатор способа оплаты. - `saved` boolean, required — Признак сохранения способа оплаты для автоплатежей: https://yookassa.ru/developers/payment-acceptance/scenario-extensions/recurring-payments/pay-with-saved. Возможные значения: true — способ оплаты сохранен для автоплатежей и выплат; false — способ оплаты не сохранен. - `status` 'pending' | 'active' | 'inactive', required — Статус проверки и сохранения способа оплаты. Возможные значения: pending — ожидает действий от пользователя; active — способ оплаты сохранен, его можно использовать для автоплатежей или выплат; inactive — способ оплаты не сохранен: возникла ошибка или не было попытки сохранения способа оплаты. - `title` string — Название способа оплаты. - `payment_purpose` string, required — Назначение платежа (не больше 210 символов). - `vat_data` union, required - B2bSberbankCalculatedVatData — Данные о налоге на добавленную стоимость (НДС). Платеж может облагаться или не облагаться НДС. Товары могут облагаться по одной ставке НДС или по разным. - `type` 'calculated' | 'untaxed' | 'mixed', required — Тип способа расчета НДС. - `rate` string, required — Налоговая ставка (в процентах). Возможные значения: 5, 7, 10, 20 и 22. С 1 января 2026 года ставка НДС 22% применяется вместо ставки 20%. - `amount` object, required — Сумма НДС. - … - B2bSberbankUntaxedVatData — Данные о налоге на добавленную стоимость (НДС). Платеж может облагаться или не облагаться НДС. Товары могут облагаться по одной ставке НДС или по разным. - `type` 'calculated' | 'untaxed' | 'mixed', required — Тип способа расчета НДС. - B2bSberbankMixedVatData — Данные о налоге на добавленную стоимость (НДС). Платеж может облагаться или не облагаться НДС. Товары могут облагаться по одной ставке НДС или по разным. - `type` 'calculated' | 'untaxed' | 'mixed', required — Тип способа расчета НДС. - `amount` object, required — Сумма НДС. - … - `payer_bank_details` B2bSberbankPayerBankDetails — Банковские реквизиты плательщика (юридического лица или ИП). - `full_name` string, required — Полное наименование организации. - `short_name` string, required — Сокращенное наименование организации. - `address` string, required — Адрес организации. - `inn` string, required — Индивидуальный налоговый номер (ИНН) организации. - `bank_name` string, required — Наименование банка организации. - `bank_branch` string, required — Отделение банка организации. - `bank_bik` string, required — Банковский идентификационный код (БИК) банка организации. - `account` string, required — Номер счета организации. - `kpp` string — Код причины постановки на учет (КПП) организации. - PaymentMethodWeChat — Способ оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods#all, который был использован для этого платежа. - `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 — Код способа оплаты — тип платежного средства, которое используется для оплаты. Подробнее о способах оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods - `id` string, required — Идентификатор способа оплаты. - `saved` boolean, required — Признак сохранения способа оплаты для автоплатежей: https://yookassa.ru/developers/payment-acceptance/scenario-extensions/recurring-payments/pay-with-saved. Возможные значения: true — способ оплаты сохранен для автоплатежей и выплат; false — способ оплаты не сохранен. - `status` 'pending' | 'active' | 'inactive', required — Статус проверки и сохранения способа оплаты. Возможные значения: pending — ожидает действий от пользователя; active — способ оплаты сохранен, его можно использовать для автоплатежей или выплат; inactive — способ оплаты не сохранен: возникла ошибка или не было попытки сохранения способа оплаты. - `title` string — Название способа оплаты. - PaymentMethodSbp — Способ оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods#all, который был использован для этого платежа. - `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 — Код способа оплаты — тип платежного средства, которое используется для оплаты. Подробнее о способах оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods - `id` string, required — Идентификатор способа оплаты. - `saved` boolean, required — Признак сохранения способа оплаты для автоплатежей: https://yookassa.ru/developers/payment-acceptance/scenario-extensions/recurring-payments/pay-with-saved. Возможные значения: true — способ оплаты сохранен для автоплатежей и выплат; false — способ оплаты не сохранен. - `status` 'pending' | 'active' | 'inactive', required — Статус проверки и сохранения способа оплаты. Возможные значения: pending — ожидает действий от пользователя; active — способ оплаты сохранен, его можно использовать для автоплатежей или выплат; inactive — способ оплаты не сохранен: возникла ошибка или не было попытки сохранения способа оплаты. - `title` string — Название способа оплаты. - `sbp_operation_id` string — Идентификатор операции в СБП (НСПК). Пример: 1027088AE4CB48CB81287833347A8777 Обязательный параметр для платежей в статусе succeeded. В остальных случаях может отсутствовать. - `payer_bank_details` SbpPayerBankDetails — Реквизиты счета, который использовался для оплаты. Обязательный параметр для платежей в статусе succeeded. В остальных случаях может отсутствовать. - `bank_id` string, required — Идентификатор банка или платежного сервиса в СБП (НСПК). - `bic` string, required — Банковский идентификационный код (БИК) банка или платежного сервиса. Используйте значение этого параметра, чтобы узнать дополнительные сведения об организации в Справочнике БИК: https://cbr.ru/PSystem/payment_system/?utm_source=w&utm_content=page#a_101477. Например, так вы можете определить название банка. - PaymentMethodSberLoan — Способ оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods#all, который был использован для этого платежа. - `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 — Код способа оплаты — тип платежного средства, которое используется для оплаты. Подробнее о способах оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods - `id` string, required — Идентификатор способа оплаты. - `saved` boolean, required — Признак сохранения способа оплаты для автоплатежей: https://yookassa.ru/developers/payment-acceptance/scenario-extensions/recurring-payments/pay-with-saved. Возможные значения: true — способ оплаты сохранен для автоплатежей и выплат; false — способ оплаты не сохранен. - `status` 'pending' | 'active' | 'inactive', required — Статус проверки и сохранения способа оплаты. Возможные значения: pending — ожидает действий от пользователя; active — способ оплаты сохранен, его можно использовать для автоплатежей или выплат; inactive — способ оплаты не сохранен: возникла ошибка или не было попытки сохранения способа оплаты. - `title` string — Название способа оплаты. - `loan_option` string — Тариф кредита, который пользователь выбрал при оплате. Возможные значения: loan — кредит; installments_XX — рассрочка, где XX — количество месяцев для выплаты рассрочки. Например, installments_3 — рассрочка на 3 месяца. Присутствует для платежей в статусе waiting_for_capture и succeeded. - `discount_amount` object — Сумма скидки для рассрочки. Присутствует для платежей в статусе waiting_for_capture и succeeded, если пользователь выбрал рассрочку. - `value` string, required — Сумма в выбранной валюте. Всегда дробное значение. Разделитель дробной части — точка, разделитель тысяч отсутствует. Количество знаков после точки зависит от выбранной валюты. Пример: 1000.00. - `currency` 'RUB' | 'EUR' | 'USD' | 'KZT' | 'BYN' | 'UAH' | 'UZS' | 'TRY' | 'INR' | 'MDL' | 'AZN' | 'AMD', required — Трехбуквенный код валюты в формате ISO-4217: https://www.iso.org/iso-4217-currency-codes.html. Пример: RUB. - `suspended_until` string, date-time — Время, когда заканчивается период охлаждения: https://yookassa.ru/docs/support/payments/credit-purchases-by-sberbank-with-cooling-off кредита или рассрочки. Указывается по UTC: https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F и передается в формате ISO 8601: https://en.wikipedia.org/wiki/ISO_8601. Присутствует для платежей в статусе pending, которые по закону: https://www.consultant.ru/document/cons_doc_LAW_498604/ попадают под процедуру охлаждения. - PaymentMethodElectronicCertificate — Способ оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods#all, который был использован для этого платежа. - `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 — Код способа оплаты — тип платежного средства, которое используется для оплаты. Подробнее о способах оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods - `id` string, required — Идентификатор способа оплаты. - `saved` boolean, required — Признак сохранения способа оплаты для автоплатежей: https://yookassa.ru/developers/payment-acceptance/scenario-extensions/recurring-payments/pay-with-saved. Возможные значения: true — способ оплаты сохранен для автоплатежей и выплат; false — способ оплаты не сохранен. - `status` 'pending' | 'active' | 'inactive', required — Статус проверки и сохранения способа оплаты. Возможные значения: pending — ожидает действий от пользователя; active — способ оплаты сохранен, его можно использовать для автоплатежей или выплат; inactive — способ оплаты не сохранен: возникла ошибка или не было попытки сохранения способа оплаты. - `title` string — Название способа оплаты. - `card` object — Данные банковской карты «Мир». - `first6` string — Первые 6 цифр номера карты (BIN). При оплате картой, сохраненной в ЮKassa: https://yookassa.ru/developers/payment-acceptance/scenario-extensions/recurring-payments/basics и других сервисах, переданный BIN может не соответствовать значениям last4, expiry_year, expiry_month. - `last4` string, required — Последние 4 цифры номера карты. - `expiry_year` string, required — Срок действия, год, YYYY. - `expiry_month` string, required — Срок действия, месяц, MM. - `card_type` 'MasterCard' | 'Visa' | 'Mir' | 'UnionPay' | 'JCB' | 'AmericanExpress' | 'DinersClub' | 'DiscoverCard' | 'InstaPayment' | 'InstaPaymentTM' | 'Laser' | 'Dankort' | 'Solo' | 'Switch' | 'Unknown', required — Тип банковской карты. Возможные значения: MasterCard (для карт Mastercard и Maestro), Visa (для карт Visa и Visa Electron), Mir, UnionPay, JCB, AmericanExpress, DinersClub, DiscoverCard, InstaPayment, InstaPaymentTM, Laser, Dankort, Solo, Switch и Unknown. - `card_product` BankCardProduct — Карточный продукт платежной системы, с которым ассоциирована банковская карта. Например, карточные продукты платежной системы Мир: Mir Classic, Mir Classic Credit, MIR Privilege Plus и другие. - `code` string, required — Код карточного продукта. Пример: MCP - `name` string — Название карточного продукта. Пример: MIR Privilege - `issuer_country` string — Код страны, в которой выпущена карта. Передается в формате ISO-3166 alpha-2: https://www.iso.org/obp/ui/#iso:pub:PUB500001:en. Пример: RU. - `issuer_name` string — Наименование банка, выпустившего карту. - `source` 'apple_pay' | 'google_pay' | 'mir_pay' — Источник данных банковской карты. Возможные значения: mir_pay, apple_pay, google_pay. Присутствует, если пользователь при оплате выбрал карту, сохраненную в Mir Pay, Apple Pay или Google Pay. - `electronic_certificate` ElectronicCertificatePayment — Данные от ФЭС НСПК для оплаты по электронному сертификату. - `amount` object, required — Сумма, которая спишется с электронного сертификата. - `value` string, required — Сумма в выбранной валюте. Всегда дробное значение. Разделитель дробной части — точка, разделитель тысяч отсутствует. Количество знаков после точки зависит от выбранной валюты. Пример: 1000.00. - `currency` 'RUB' | 'EUR' | 'USD' | 'KZT' | 'BYN' | 'UAH' | 'UZS' | 'TRY' | 'INR' | 'MDL' | 'AZN' | 'AMD', required — Трехбуквенный код валюты в формате ISO-4217: https://www.iso.org/iso-4217-currency-codes.html. Пример: RUB. - `basket_id` string, required — Идентификатор корзины покупки, сформированной в НСПК. - `articles` ElectronicCertificateApprovedPaymentArticle[] — Одобренная корзина покупки — список товаров, одобренных к оплате по электронному сертификату. Присутствует только при оплате на готовой странице ЮKassa: https://yookassa.ru/developers/payment-acceptance/integration-scenarios/manual-integration/other/electronic-certificate/ready-made-payment-form. - `article_number` integer, required — Порядковый номер товара в корзине. От 1 до 999 включительно. - `tru_code` string, required — Код ТРУ. 30 символов, две группы цифр, разделенные точкой. Формат: NNNNNNNNN.NNNNNNNNNYYYYMMMMZZZ, где NNNNNNNNN.NNNNNNNNN — код вида ТРУ по Перечню ТРУ: https://esnsi.gosuslugi.ru/classifiers/10616/data?pg=1&p=1, YYYY — код производителя, MMMM — код модели, ZZZ — код страны производителя. Пример: 329921120.06001010200080001643 Как сформировать код ТРУ: https://yookassa.ru/developers/payment-acceptance/integration-scenarios/manual-integration/other/electronic-certificate/basics#payments-preparations-tru-code - `article_code` string — Код товара в вашей системе. Максимум 128 символов. - `certificates` ElectronicCertificate[], required — Список электронных сертификатов, которые используются для оплаты покупки. - `certificate_id` string, required — Идентификатор сертификата. От 20 до 30 символов. - `tru_quantity` integer, required — Количество единиц товара, которое одобрили для оплаты по этому электронному сертификату. - `available_compensation` object, required — Максимально допустимая сумма, которую может покрыть электронный сертификат для оплаты одной единицы товара. Пример: сертификат может компенсировать максимум 1000 рублей для оплаты этого товара. - … - `applied_compensation` object, required — Сумма, которую одобрили для оплаты по сертификату за одну единицу товара. Пример: из 1000 рублей одобрили 500 рублей для оплаты по сертификату. - … - PaymentMethodSberBnpl — Способ оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods#all, который был использован для этого платежа. - `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 — Код способа оплаты — тип платежного средства, которое используется для оплаты. Подробнее о способах оплаты: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods - `id` string, required — Идентификатор способа оплаты. - `saved` boolean, required — Признак сохранения способа оплаты для автоплатежей: https://yookassa.ru/developers/payment-acceptance/scenario-extensions/recurring-payments/pay-with-saved. Возможные значения: true — способ оплаты сохранен для автоплатежей и выплат; false — способ оплаты не сохранен. - `status` 'pending' | 'active' | 'inactive', required — Статус проверки и сохранения способа оплаты. Возможные значения: pending — ожидает действий от пользователя; active — способ оплаты сохранен, его можно использовать для автоплатежей или выплат; inactive — способ оплаты не сохранен: возникла ошибка или не было попытки сохранения способа оплаты. - `title` string — Название способа оплаты. - `captured_at` string, date-time — Время подтверждения платежа. Указывается по UTC: https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F и передается в формате ISO 8601: https://en.wikipedia.org/wiki/ISO_8601. - `created_at` string, date-time, required — Время создания заказа. Указывается по UTC: https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F и передается в формате ISO 8601: https://en.wikipedia.org/wiki/ISO_8601. Пример: 2017-11-03T11:52:31.827Z - `expires_at` string, date-time — Время, до которого вы можете бесплатно отменить или подтвердить платеж. В указанное время платеж в статусе waiting_for_capture будет автоматически отменен. Указывается по UTC: https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F и передается в формате ISO 8601: https://en.wikipedia.org/wiki/ISO_8601. Пример: 2017-11-03T11:52:31.827Z - `confirmation` union - ConfirmationRedirect — Выбранный способ подтверждения платежа. Присутствует, когда платеж ожидает подтверждения от пользователя. Подробнее о сценариях подтверждения: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-process#user-confirmation - `type` 'redirect' | 'external' | 'qr' | 'embedded' | 'mobile_application', required — Тип пользовательского процесса подтверждения платежа | - redirect - необходимо направить пользователя на страницу партнера; - external - необходимо подождать, пока пользователь самостоятельно подтвердит платеж; - qr - необходимо сгенерировать QR-код и отобразить его на странице оплаты, чтобы пользователь смог подтвердить платеж; - embedded - необходимо отобразить платежный виджет ЮKassa; - mobile_application - необходимо перенаправить пользователя в приложение партнера для оплаты. - `enforce` boolean — Запрос на проведение платежа с аутентификацией по 3-D Secure. Будет работать, если оплату банковской картой вы по умолчанию принимаете без подтверждения платежа пользователем. В остальных случаях аутентификацией по 3-D Secure будет управлять ЮKassa. Если хотите принимать платежи без дополнительного подтверждения пользователем, напишите вашему менеджеру ЮKassa. - `return_url` string — URL, на который вернется пользователь после подтверждения или отмены платежа на веб-странице. Не более 2048 символов. - `confirmation_url` string, required — URL, на который необходимо перенаправить пользователя для подтверждения оплаты. - ConfirmationExternal — Выбранный способ подтверждения платежа. Присутствует, когда платеж ожидает подтверждения от пользователя. Подробнее о сценариях подтверждения: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-process#user-confirmation - `type` 'redirect' | 'external' | 'qr' | 'embedded' | 'mobile_application', required — Тип пользовательского процесса подтверждения платежа | - redirect - необходимо направить пользователя на страницу партнера; - external - необходимо подождать, пока пользователь самостоятельно подтвердит платеж; - qr - необходимо сгенерировать QR-код и отобразить его на странице оплаты, чтобы пользователь смог подтвердить платеж; - embedded - необходимо отобразить платежный виджет ЮKassa; - mobile_application - необходимо перенаправить пользователя в приложение партнера для оплаты. - ConfirmationQr — Выбранный способ подтверждения платежа. Присутствует, когда платеж ожидает подтверждения от пользователя. Подробнее о сценариях подтверждения: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-process#user-confirmation - `type` 'redirect' | 'external' | 'qr' | 'embedded' | 'mobile_application', required — Тип пользовательского процесса подтверждения платежа | - redirect - необходимо направить пользователя на страницу партнера; - external - необходимо подождать, пока пользователь самостоятельно подтвердит платеж; - qr - необходимо сгенерировать QR-код и отобразить его на странице оплаты, чтобы пользователь смог подтвердить платеж; - embedded - необходимо отобразить платежный виджет ЮKassa; - mobile_application - необходимо перенаправить пользователя в приложение партнера для оплаты. - `confirmation_data` string, required — Данные для генерации QR-кода. - ConfirmationEmbedded — Выбранный способ подтверждения платежа. Присутствует, когда платеж ожидает подтверждения от пользователя. Подробнее о сценариях подтверждения: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-process#user-confirmation - `type` 'redirect' | 'external' | 'qr' | 'embedded' | 'mobile_application', required — Тип пользовательского процесса подтверждения платежа | - redirect - необходимо направить пользователя на страницу партнера; - external - необходимо подождать, пока пользователь самостоятельно подтвердит платеж; - qr - необходимо сгенерировать QR-код и отобразить его на странице оплаты, чтобы пользователь смог подтвердить платеж; - embedded - необходимо отобразить платежный виджет ЮKassa; - mobile_application - необходимо перенаправить пользователя в приложение партнера для оплаты. - `confirmation_token` string, required — Токен для инициализации платежного виджета ЮKassa: https://yookassa.ru/developers/payment-acceptance/integration-scenarios/widget/basics. - ConfirmationMobileApplication — Выбранный способ подтверждения платежа. Присутствует, когда платеж ожидает подтверждения от пользователя. Подробнее о сценариях подтверждения: https://yookassa.ru/developers/payment-acceptance/getting-started/payment-process#user-confirmation - `type` 'redirect' | 'external' | 'qr' | 'embedded' | 'mobile_application', required — Тип пользовательского процесса подтверждения платежа | - redirect - необходимо направить пользователя на страницу партнера; - external - необходимо подождать, пока пользователь самостоятельно подтвердит платеж; - qr - необходимо сгенерировать QR-код и отобразить его на странице оплаты, чтобы пользователь смог подтвердить платеж; - embedded - необходимо отобразить платежный виджет ЮKassa; - mobile_application - необходимо перенаправить пользователя в приложение партнера для оплаты. - `confirmation_url` string, required — Диплинк на мобильное приложение, в котором пользователь подтверждает платеж. - `test` boolean, required — Признак тестовой операции. - `refunded_amount` object — Сумма, которая вернулась пользователю. Присутствует, если у этого платежа есть успешные возвраты. - `value` string, required — Сумма в выбранной валюте. Всегда дробное значение. Разделитель дробной части — точка, разделитель тысяч отсутствует. Количество знаков после точки зависит от выбранной валюты. Пример: 1000.00. - `currency` 'RUB' | 'EUR' | 'USD' | 'KZT' | 'BYN' | 'UAH' | 'UZS' | 'TRY' | 'INR' | 'MDL' | 'AZN' | 'AMD', required — Трехбуквенный код валюты в формате ISO-4217: https://www.iso.org/iso-4217-currency-codes.html. Пример: RUB. - `paid` boolean, required — Признак оплаты заказа. - `refundable` boolean, required — Возможность провести возврат по API. - `receipt_registration` 'pending' | 'succeeded' | 'canceled' — Статус регистрации чека. Возможные значения: pending — данные в обработке; succeeded — чек успешно зарегистрирован; canceled — чек зарегистрировать не удалось; если используете Чеки от ЮKassa: https://yookassa.ru/developers/payment-acceptance/receipts/54fz/yoomoney/basics, обратитесь в техническую поддержку, в остальных случаях сформируйте чек вручную. Присутствует, если вы используете решения ЮKassa для отправки чеков в налоговую: https://yookassa.ru/developers/payment-acceptance/receipts/basics. - `metadata` Metadata — Любые дополнительные данные, которые нужны вам для работы (например, ваш внутренний идентификатор заказа). Передаются в виде набора пар «ключ-значение» и возвращаются в ответе от ЮKassa. Ограничения: максимум 16 ключей, имя ключа не больше 32 символов, значение ключа не больше 512 символов, тип данных — строка в формате UTF-8. - `cancellation_details` PaymentCancellationDetails — Комментарий к статусу canceled: кто отменил платеж и по какой причине. Подробнее про неуспешные платежи: https://yookassa.ru/developers/payment-acceptance/after-the-payment/declined-payments - `party` 'yoo_money' | 'payment_network' | 'merchant', required — Участник процесса платежа, который принял решение об отмене транзакции. Может принимать значения yoo_money, payment_network и merchant. Подробнее про инициаторов отмены платежа: https://yookassa.ru/developers/payment-acceptance/after-the-payment/declined-payments#cancellation-details-party - `reason` '3d_secure_failed' | 'call_issuer' | 'card_expired' | 'payment_method_limit_exceeded' | 'payment_method_restricted' | 'country_forbidden' | 'general_decline' | 'fraud_suspected' | 'identification_required' | 'insufficient_funds' | 'invalid_card_number' | 'invalid_csc' | 'issuer_unavailable' | 'canceled_by_merchant' | 'permission_revoked' | 'internal_timeout' | 'expired_on_confirmation' | 'expired_on_capture' | 'unsupported_mobile_operator' | 'deal_expired', required — Причина отмены платежа. Перечень и описание возможных значений: https://yookassa.ru/developers/payment-acceptance/after-the-payment/declined-payments#cancellation-details-reason - `authorization_details` AuthorizationDetails — Данные об авторизации платежа при оплате банковской картой. Присутствуют только для этих способов оплаты: банковская карта, Mir Pay, SberPay, T-Pay. - `rrn` string — Retrieval Reference Number — идентификатор банковской транзакции. - `auth_code` string — Код авторизации. Выдается эмитентом и подтверждает проведение авторизации. - `three_d_secure` ThreeDSecureDetails, required — Данные о прохождении пользователем аутентификации по 3‑D Secure для подтверждения платежа. - `applied` boolean, required — Отображение пользователю формы для прохождения аутентификации по 3‑D Secure. Возможные значения: true — ЮKassa отобразила пользователю форму, чтобы он мог пройти аутентификацию по 3‑D Secure; false — платеж проходил без аутентификации по 3‑D Secure. - `transfers` Transfer[] — Данные о распределении денег — сколько и в какой магазин нужно перевести. Присутствует, если вы используете Сплитование платежей: https://yookassa.ru/developers/solutions-for-platforms/split-payments/basics. - `account_id` string, required — Идентификатор магазина, в пользу которого вы принимаете оплату. Выдается ЮKassa, отображается в разделе Продавцы: https://yookassa.ru/my/marketplace/sellers личного кабинета (столбец shopId). - `amount` object, required — Сумма, которую необходимо перечислить магазину. - `value` string, required — Сумма в выбранной валюте. Всегда дробное значение. Разделитель дробной части — точка, разделитель тысяч отсутствует. Количество знаков после точки зависит от выбранной валюты. Пример: 1000.00. - `currency` 'RUB' | 'EUR' | 'USD' | 'KZT' | 'BYN' | 'UAH' | 'UZS' | 'TRY' | 'INR' | 'MDL' | 'AZN' | 'AMD', required — Трехбуквенный код валюты в формате ISO-4217: https://www.iso.org/iso-4217-currency-codes.html. Пример: RUB. - `status` 'pending' | 'waiting_for_capture' | 'succeeded' | 'canceled', required — Статус распределения денег между магазинами. Возможные значения: pending, waiting_for_capture, succeeded, canceled. - `platform_fee_amount` object — Комиссия за проданные товары и услуги, которая удерживается с магазина в вашу пользу. - `value` string, required — Сумма в выбранной валюте. Всегда дробное значение. Разделитель дробной части — точка, разделитель тысяч отсутствует. Количество знаков после точки зависит от выбранной валюты. Пример: 1000.00. - `currency` 'RUB' | 'EUR' | 'USD' | 'KZT' | 'BYN' | 'UAH' | 'UZS' | 'TRY' | 'INR' | 'MDL' | 'AZN' | 'AMD', required — Трехбуквенный код валюты в формате ISO-4217: https://www.iso.org/iso-4217-currency-codes.html. Пример: RUB. - `description` string — Описание транзакции (не более 128 символов), которое продавец увидит в личном кабинете ЮKassa. Например: «Заказ маркетплейса №72». - `metadata` Metadata — Любые дополнительные данные, которые нужны вам для работы (например, ваш внутренний идентификатор заказа). Передаются в виде набора пар «ключ-значение» и возвращаются в ответе от ЮKassa. Ограничения: максимум 16 ключей, имя ключа не больше 32 символов, значение ключа не больше 512 символов, тип данных — строка в формате UTF-8. - `deal` object — Данные о сделке, в составе которой проходит платеж. Присутствует, если вы проводите Безопасную сделку: https://yookassa.ru/developers/solutions-for-platforms/safe-deal/basics. - `id` string, required — Идентификатор сделки. - `settlements` SettlementPayoutPayment[], required — Данные о распределении денег. - `type` 'payout', required — Тип операции. - `amount` object, required — Сумма вознаграждения продавца. - `value` string, required — Сумма в выбранной валюте. Всегда дробное значение. Разделитель дробной части — точка, разделитель тысяч отсутствует. Количество знаков после точки зависит от выбранной валюты. Пример: 1000.00. - `currency` 'RUB' | 'EUR' | 'USD' | 'KZT' | 'BYN' | 'UAH' | 'UZS' | 'TRY' | 'INR' | 'MDL' | 'AZN' | 'AMD', required — Трехбуквенный код валюты в формате ISO-4217: https://www.iso.org/iso-4217-currency-codes.html. Пример: RUB. - `merchant_customer_id` string — Идентификатор покупателя в вашей системе, например электронная почта или номер телефона. Не более 200 символов. Присутствует, если вы хотите запомнить банковскую карту и отобразить ее при повторном платеже в виджете ЮKassa: https://yookassa.ru/developers/payment-acceptance/integration-scenarios/widget/basics. - `invoice_details` object — Данные о выставленном счете, в рамках которого проведен платеж. - `id` string — Идентификатор счета в ЮKassa. - `next_cursor` string — Указатель на следующий фрагмент списка. Обязательный параметр, если размер списка больше размера выдачи (limit) и конец выдачи не достигнут. ## Other responses - `400` — Запрос не может быть обработан. Причиной может быть неправильный синтаксис запроса, ошибка в обязательных параметрах запроса, их отсутствие или неподдерживаемый метод. - `401` — В заголовке Authorization указан неверный ключ. - `403` — Секретный ключ указан верно, но не хватает прав для совершения операции. - `500` — Внутренняя ошибка сервера ЮKassa. --- [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/e79983ebb73d/schema)