- Тип способа оплаты в API:
yoo_money - Сценарий подтверждения: Redirect
- Срок оплаты: 1 час
- Холдирование: 7 дней, при оплате сохраненным способом — 6 часов
- Код в реестре: PC
- Возврат: да, полный и частичный
- Срок возврата: моментально
- Автоплатежи: да
- Лимиты: минимальный размер платежа — 1 рубль, максимальный — от 15 000 до 250 000 рублей (зависит от статуса кошелька), есть дополнительные ограничения
Готовые решения:
- Умный платеж
- Виджет ЮKassa
- Мобильные SDK для iOS и Android
Самостоятельная интеграция: Оплата на странице ЮMoney
Шаг 1. Создайте платеж , в объекте
payment_method_data передайте тип yoo_money, а в объекте confirmation передайте тип redirect и адрес страницы на вашей стороне, на которую пользователь вернется после оплаты (в параметре return_url).Пример запроса
curl https://api.yookassa.ru/v3/payments \ -X POST \ -u <Идентификатор магазина>:<Секретный ключ> \ -H 'Idempotence-Key: <Ключ идемпотентности>' \ -H 'Content-Type: application/json' \ -d '{ "amount": { "value": "2.00", "currency": "RUB" }, "payment_method_data": { "type": "yoo_money" }, "confirmation": { "type": "redirect", "return_url": "https://www.example.com/return_url" }, "description": "Заказ №72" }'
Шаг 2. Перенаправьте пользователя на страницу ЮKassa (ссылка на нее придет в параметре
confirmation_url). На этой странице пользователь введет данные кошелька и подтвердит платеж.Пример созданного объекта платежа
{ "id": "22c5d0f0-000f-5000-8000-13ece77bc6c1", "status": "pending", "paid": false, "amount": { "value": "2.00", "currency": "RUB" }, "confirmation": { "type": "redirect", "confirmation_url": "https://yoomoney.ru/payments/internal/confirmation?orderId=22c5d0f0-000f-5000-8000-13ece77bc6c1" }, "created_at": "2018-06-27T16:37:04.513Z", "description": "Заказ №72", "metadata": {}, "payment_method": { "type": "yoo_money", "id": "22c5d0f0-000f-5000-8000-13ece77bc6c1", "saved": false }, "recipient": { "account_id": "100500", "gateway_id": "100700" }, "refundable": false, "test": false }
Если оплата из кошелька или привязанной к кошельку картой не прошла (например, не хватило денег), ЮKassa отобразит пользователю сообщение об ошибке и предложит попробовать оплатить еще раз.
Шаг 3. Дождитесь успешного завершения платежа: подождите, когда придет уведомление от ЮKassa, или периодически отправляйте запросы, чтобы получить информацию о платеже .
Основы проведения платежейНеуспешные платежиОтправка чеков в налоговуюТестирование платежей