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