Самый простой способ интеграции с ЮKassa. Вам нужно только перенаправить пользователя на страницу ЮKassa, где он выберет подходящий способ, введет данные для оплаты и ее подтвердит. Чтобы принять оплату по этому сценарию, необходимо создать платеж и реализовать сценарий подтверждения Redirect.
Умный платеж поддерживает все способы оплаты, кроме оплаты через СберБанк Бизнес Онлайн. На платежной форме отображаются все способы, доступные вашему магазину.
Подключая Умный платеж, вы соглашаетесь с условиями использования платежного сервиса Apple Pay.
При оплате через Apple Pay или Google Pay страница платежной формы обрабатывает неуспешные попытки: если платеж не прошел, платежная форма отображает пользователю сообщение об ошибке и предлагает попробовать оплатить еще раз с возможностью повторного выбора способа оплаты. Вы можете отключить эту настройку через менеджера ЮKassa и обрабатывать неуспешные попытки самостоятельно.
В Умном платеже нельзя сохранить способ оплаты для автоплатежей.
Шаг 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": "100001", "gateway_id": "1000001" }, "refundable": false, "test": false }
Шаг 3. Дождитесь успешного завершения платежа: подождите, когда придет уведомление от ЮKassa, или периодически отправляйте запросы, чтобы получить информацию о платеже .
Есть вопросы или замечания по документации?
Можем созвониться и обсудить их лично: мы поможем вам разобраться, а вы нам — понять, что тут нужно улучшить.
Для этого оставьте свои контакты и выберите время.
Да, хочу обсудить