Если используете мобильные SDK, для проведения платежа вам нужно обменять в SDK платежные данные на токен и передать его в запросе к API при создании платежа.
Шаг 1. Получите платежный токен в iOS или Android SDK. Токен будет содержать выбранный способ оплаты, платежные данные и данные о сценарии подтверждения платежа.
Шаг 2. Передайте токен на ваш сервер.
Шаг 3. Создайте платеж , в параметре
payment_token
передайте платежный токен.Пример запроса
curl https://api.yookassa.ru/v3/payments \ -X POST \ -u <Идентификатор магазина>:<Секретный ключ> \ -H 'Idempotence-Key: <Ключ идемпотентности>' \ -H 'Content-Type: application/json' \ -d '{ "payment_token": "pt-28cd3959-0000-500c-a000-03b4de9b24a7", "amount": { "value": "2.00", "currency": "RUB" }, "capture": false, "description": "Заказ №72" }'
Шаг 4. Если платеж вернулся в статусе
pending
, передайте confirmation_url
в мобильный SDK.Пример созданного объекта платежа
{ "id": "23d93cac-000f-5000-8000-126628f15141", "status": "pending", "paid": false, "amount": { "value": "2.00", "currency": "RUB" }, "confirmation": { "type": "redirect", "confirmation_url": "<Ссылка для прохождения 3-D Secure>" }, "created_at": "2019-01-22T14:30:45.129Z", "description": "Заказ №72", "metadata": {}, "recipient": { "account_id": "100500", "gateway_id": "100700" }, "refundable": false, "test": false }
Шаг 5. Дождитесь успешного завершения платежа: подождите, когда придет уведомление от ЮKassa, или периодически отправляйте запросы, чтобы получить информацию о платеже .
iOS SDKAndroid SDKНеуспешные платежиОсновы работы с API