- Тип способа оплаты в API: bank_card
- Сценарий подтверждения: Redirect
- Срок оплаты: 1 час
- Холдирование: 7 дней
- Код в реестре: AC
- Возврат: да, полный и частичный
- Срок возврата: от 0 до 3 дней (зависит от эмитента)
- Автоплатежи: да
- Лимиты: минимальный размер платежа — 1 рубль, максимальный — 250 000 рублей, есть дополнительные ограничения
Готовые решения:
- Умный платеж
- Виджет ЮKassa
- Мобильные SDK для iOS и Android
- Платежная форма для веба в вашем дизайне — Checkout.js
- Платежная форма для веба в готовом дизайне — Checkout UI
Самостоятельная интеграция:
Шаг 1. Создайте платеж , в объекте
payment_method_data
передайте тип bank_card
, в объекте confirmation
передайте тип redirect
и адрес страницы на вашей стороне, на которую вернется пользователь (в параметре return_url
).Пример запроса
cURL
PHP
Python
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": "bank_card" }, "confirmation": { "type": "redirect", "return_url": "https://www.merchant-website.com/return_url" }, "description": "Заказ №72" }'
Шаг 2. Перенаправьте пользователя на страницу для ввода данных (ссылка на нее придет в параметре
confirmation_url
).Пример созданного объекта платежа
JSON
{ "id": "22c5d173-000f-5000-9000-1bdf241d4651", "status": "pending", "paid": false, "amount": { "value": "2.00", "currency": "RUB" }, "confirmation": { "type": "redirect", "return_url": "https://www.merchant-website.com/return_url", "confirmation_url": "https://yoomoney.ru/payments/external/confirmation?orderId=22c5d173-000f-5000-9000-1bdf241d4651" }, "created_at": "2018-06-27T16:39:15.865Z", "description": "Заказ №72", "metadata": {}, "payment_method": { "type": "bank_card", "id": "22c5d173-000f-5000-9000-1bdf241d4651", "saved": false }, "recipient": { "account_id": "100001", "gateway_id": "1000001" }, "refundable": false, "test": false }
Шаг 3. Дождитесь успешного завершения платежа: подождите, когда придет уведомление от ЮKassa, или периодически отправляйте запросы, чтобы получить информацию о платеже .
Чтобы использовать эту возможность, вам нужно получить сертификат на соответствие требованиям PCI DSS.
Шаг 1. Создайте платеж , в объекте
payment_method_data
передайте тип bank_card
и объект card
с данными банковской карты, в объекте confirmation
передайте тип redirect
и адрес страницы на вашей стороне, на которую пользователь вернется после оплаты (в параметре return_url
).Пример запроса
cURL
PHP
Python
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": "bank_card", "card": { "cardholder": "MR CARDHOLDER", "csc": "213", "expiry_month": "01", "expiry_year": "2020", "number": "5469550010800081" } }, "confirmation": { "type": "redirect", "return_url": "https://www.merchant-website.com/return_url" }, "description": "Заказ №72" }'
Шаг 2. Перенаправьте пользователя на страницу аутентификации по 3-D Secure (ссылка на нее придет в параметре
confirmation_url
).Пример созданного объекта платежа
JSON
{ "id": "22c5d173-000f-5000-9000-1bdf241d4651", "status": "pending", "paid": false, "amount": { "value": "2.00", "currency": "RUB" }, "confirmation": { "type": "redirect", "confirmation_url": "<Ссылка для прохождения 3-D Secure>" }, "created_at": "2019-03-14T15:20:35.394Z", "description": "Заказ №72", "metadata": {}, "payment_method": { "type": "bank_card", "id": "22c5d173-000f-5000-9000-1bdf241d4651", "saved": false }, "recipient": { "account_id": "100001", "gateway_id": "1000001" }, "refundable": false, "test": false }
Шаг 3. Дождитесь успешного завершения платежа: подождите, когда придет уведомление от ЮKassa, или периодически отправляйте запросы, чтобы получить информацию о платеже .
Нужно согласовать с менеджером ЮKassa.
Вы можете отключить 3-D Secure, тогда передавать объект
Основы проведения платежейНеуспешные платежиОплата по 54-ФЗТестированиеconfirmation
не нужно. Если вы хотите запросить прохождение 3-D Secure пользователем, в объекте confirmation
передайте тип redirect
, адрес страницы на вашей стороне, на которую пользователь вернется после оплаты (в параметре return_url
) и параметр enforce
со значением true
.