Умный платеж
Самый простой способ интеграции с ЮKassa. Вам нужно только перенаправить пользователя на страницу ЮKassa, где он выберет подходящий способ, введет данные для оплаты и ее подтвердит. Чтобы принять оплату по этому сценарию, необходимо создать платеж и реализовать сценарий подтверждения Redirect.
Особенности
Умный платеж поддерживает все способы оплаты, кроме оплаты через СберБанк Бизнес Онлайн. На платежной форме отображаются все способы, доступные вашему магазину.
Если оплата не проходит, платежная форма обрабатывает неуспешные попытки: она отображает пользователю сообщение об ошибке и предлагает попробовать оплатить еще раз с повторным выбором способа оплаты. Доступно при оплате произвольной банковской картой, через SberPay, СБП и из кошелька ЮMoney. Вы можете отключить эту настройку через менеджера ЮKassa и обрабатывать неуспешные попытки самостоятельно.
С помощью Умного платежа пользователь сможет сохранить для автоплатежей следующие способы оплаты:
Проведение платежа
Шаг 1. Создайте платеж , передайте в запросе объект
confirmation
с типом
redirect
и адресом страницы, на которую вернется пользователь после оплаты. Данные о способе оплаты (
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.merchant-website.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, или периодически отправляйте запросы, чтобы получить информацию о платеже .
Что почитать еще
Сценарии интеграцииОтправка чеков в налоговуюНеуспешные платежиВходящие уведомления