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