Docs
API ЮKassa
Инструкции
Старые версии API
Помощь
Подключить ЮKassa

Умный платеж

Самый простой способ интеграции с ЮKassa. Вам нужно только перенаправить пользователя на страницу ЮKassa, где он выберет подходящий способ, введет данные для оплаты и ее подтвердит. Чтобы принять оплату по этому сценарию, необходимо создать платеж и реализовать сценарий подтверждения Redirect.
Пример платежной формы
Пример платежной формы
Особенности
Умный платеж поддерживает все способы оплаты, кроме оплаты через СберБанк Бизнес Онлайн и по электронному сертификату. На платежной форме будут отображаться те способы, которые подключены в вашем магазине.
Если проводите платежи в две стадии или сохраняете способ оплаты для автоплатежей, на платежной форме отображаются только те способы, которые поддерживают используемую вами опцию. Подробнее о способах оплаты и их возможностях
Пример: если вы подключили СБП и проводите платеж в две стадии, то этот способ не отобразится на платежной форме, потому что не поддерживает эту опцию. Если это единственный способ оплаты, который есть в вашем магазине, то вы получите ошибку.
Оплата через Mir Pay будет доступна только для мобильных устройств на Android.
Если оплата не проходит, платежная форма обрабатывает неуспешные попытки: она отображает пользователю сообщение об ошибке и предлагает попробовать оплатить еще раз с повторным выбором способа оплаты. Доступно при оплате произвольной банковской картой, через Mir Pay, SberPay, T-Pay, СБП, сервис «Плати частями» и из кошелька ЮMoney. Вы можете отключить эту настройку через менеджера ЮKassa и обрабатывать неуспешные попытки самостоятельно.
Проведение платежа
Шаг 1. Создайте платеж. Передайте в запросе объект confirmation с типом redirect и адресом страницы, на которую вернется пользователь после оплаты. Этот адрес должен быть абсолютным — с указанием протокола и домена сайта. Пример: https://example.com/return_url.
Данные о способе оплаты (payment_method_data, payment_token, payment_method_id) в запросе передавать не нужно.
Пример запроса
cURL
PHP
Python
curl https://api.yookassa.ru/v3/payments \
  -X POST \
  -u <Идентификатор магазина>:<Секретный ключ> \
  -H 'Idempotence-Key: <Ключ идемпотентности>' \
  -H 'Content-Type: application/json' \
  -d '{
        "amount": {
          "value": "100.00",
          "currency": "RUB"
        },
        "capture": true,
        "confirmation": {
          "type": "redirect",
          "return_url": "https://www.example.com/return_url"
        },
        "description": "Заказ №1"
      }'
Шаг 2. Перенаправьте пользователя на confirmation_url, который придет в объекте платежа. Это ссылка на страницу ЮKassa, на которой пользователь выберет нужный способ и введет данные для оплаты.
Пример созданного объекта платежа
JSON
{
  "id": "23d93cac-000f-5000-8000-126628f15141",
  "status": "pending",
  "paid": false,
  "amount": {
    "value": "100.00",
    "currency": "RUB"
  },
  "confirmation": {
    "type": "redirect",
    "confirmation_url": "https://yoomoney.ru/api-pages/v2/payment-confirm/epl?orderId=23d93cac-000f-5000-8000-126628f15141"
  },
  "created_at": "2019-01-22T14:30:45.129Z",
  "description": "Заказ №1",
  "metadata": {},
  "recipient": {
    "account_id": "100500",
    "gateway_id": "100700"
  },
  "refundable": false,
  "test": false
}
Шаг 3. Дождитесь успешного завершения платежа: подождите, когда придет уведомление от ЮKassa, или периодически отправляйте запросы, чтобы получить информацию о платеже.
Что почитать еще
© 2025, ООО НКО «ЮМани»