---
title: "Информация о способе оплаты"
method: GET
path: "/payment_methods/{payment_method_id}"
tags: ["Способы оплаты"]
---

# Информация о способе оплаты

`GET /payment_methods/{payment_method_id}`

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

## Path parameters

- `payment_method_id` string, required — Идентификатор сохраненного способа оплаты: https://yookassa.ru/developers/payment-acceptance/scenario-extensions/recurring-payments/basics.

## Response `200`

Запрос успешно обработан

- SavePaymentMethodBankCard — Сохраненный способ оплаты.
  - `type` 'bank_card', required — Тип способа оплаты.
  - `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 — способ оплаты не сохранен: пользователь не подтвердил привязку платежного средства или при сохранении способа оплаты возникла ошибка. Чтобы узнать подробности, обратитесь в техническую поддержку ЮKassa.
  - `holder` object, required — Данные магазина, для которого сохраняется способ оплаты.
    - `account_id` string, required — Идентификатор магазина в ЮKassa.
    - `gateway_id` string — Идентификатор субаккаунта. Используется для разделения потоков платежей в рамках одного аккаунта.
  - `title` string — Название способа оплаты.
  - `confirmation` PaymentMethodsConfirmationRedirect — Выбранный сценарий подтверждения привязки. Присутствует, когда привязка ожидает подтверждения от пользователя.
    - `type` 'redirect', required — Код сценария подтверждения пользователем привязки платежного средства к вашему магазину в ЮKassa.
    - `confirmation_url` string, required — URL, на который необходимо перенаправить пользователя для подтверждения привязки.
    - `enforce` boolean — Запрос на проведение привязки с аутентификацией по 3-D Secure. Будет работать, если оплату банковской картой вы по умолчанию принимаете без подтверждения платежа пользователем. В остальных случаях аутентификацией по 3-D Secure будет управлять ЮKassa. Если хотите принимать платежи и создавать привязки без дополнительного подтверждения пользователем, напишите вашему менеджеру ЮKassa.
    - `return_url` string — URL, на который вернется пользователь после подтверждения или отмены привязки на веб-странице. Не более 2048 символов.
  - `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.

## Other responses

- `400` — Запрос не может быть обработан. Причиной может быть неправильный синтаксис запроса, ошибка в обязательных параметрах запроса, их отсутствие или неподдерживаемый метод.
- `401` — В заголовке Authorization указан неверный ключ.
- `403` — Секретный ключ указан верно, но не хватает прав для совершения операции.
- `404` — Сущность не найдена.
- `429` — Слишком много запросов одновременно отправляется в API. Повторите запрос позже.
- `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)