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