Что это
API ЮKassa позволяет создать платеж, узнать его состояние и выполнить разрешенные операции, например возврат. Он нужен, когда магазин должен надежно связать оплату с заказом и передать данные в учетную систему.
REST API не является ИИ-бухгалтером. Для работы с внешними агентами у ЮKassa есть отдельный MCP-сервер со своим подключением и набором инструментов. Наличие этого сервера не дает модели право самостоятельно распоряжаться деньгами.
Начните с тестового магазина: там можно провести учебную оплату без перевода денег. Первый результат - подтвердить конкретный тестовый платеж по API, а не по возвращению браузера на сайт. Рабочий прием платежей требует отдельного подключения и проверки.
Ключевые параметры
- Категория: Операционные задачи
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- Есть отдельный тестовый магазин, в котором деньги не переводятся.
- Объект платежа дает проверяемый статус, сумму, валюту и ID.
- Ключ идемпотентности помогает безопасно повторить запрос создания с теми же параметрами.
- Уведомления позволяют реагировать на изменение платежа, а не постоянно опрашивать все заказы.
Ограничения
- Нужны собственный магазин, разрешенный доступ и серверная интеграция.
- waiting_for_capture еще не означает окончательно завершенный платеж.
- Уведомления могут приходить повторно: обработчик должен проверять состояние и исключать повторную выдачу заказа.
- Комиссии, фискализация и условия рабочего магазина не исчезают из-за подключения API.
Как использовать
1. Подготовка. Зарегистрируйте отдельный тестовый магазин ЮKassa и получите его shopId и секретный ключ. Запишите учебную сумму 100.00 RUB. Не используйте рабочий ключ или настоящую карту.
2. Настройка. Отправляйте запросы с сервера на https://api.yookassa.ru/v3/ с HTTP Basic shopId:секретный_ключ. По официальному быстрому старту создайте один тестовый платеж через POST /payments: amount, capture=true, confirmation.type=redirect и свой return_url. Передайте уникальный Idempotence-Key и Content-Type: application/json; сохраните id платежа.
3. Первый результат. Откройте полученный confirmation.confirmation_url и завершите оплату тестовой картой из руководства. Затем выполните GET https://api.yookassa.ru/v3/payments/<payment_id> с теми же тестовыми credentials. Получите статус, amount и test; сформируйте короткую строку «учебный заказ - сумма - состояние».
4. Проверка. Сверьте ID и сумму с тестовым кабинетом, убедитесь в test=true и status=succeeded. pending и waiting_for_capture не считайте завершением оплаты. Возврат на return_url не подтверждает платеж. Перед рабочим запуском добавьте проверку уведомлений, повторных событий и соответствия платежа заказу; не тестируйте возвраты на реальных деньгах.
Примеры сценариев
- Проверить оплату учебного заказа без движения денег.
- Обнаружить оплаченный заказ с неверно сопоставленным ID.
- Подготовить обезличенную очередь расхождений для бухгалтера.
Доступ и оплата
- Модель оплаты: Платно
- Бесплатный тариф: Нет
- Работа в РФ: Да
- VPN: Не нужен
- Русский интерфейс: Да
- Русский язык: Не известно
Тестовый магазин позволяет проверить интеграцию без реальных платежей; это не бесплатный рабочий эквайринг. Для приема денег нужны рабочее подключение и договор. Комиссии, применимый НДС и расходы на чеки проверяйте по условиям магазина, а не по универсальной цифре из обзора.
Когда не подходит
- Выдавать заказ только по переходу на return_url
- Отправлять модели секретный ключ магазина
- Делать рабочие возвраты по непроверенной рекомендации ИИ
Альтернативы
Stripe API - другая платежная платформа с собственной географией и условиями подключения. QuickBooks Online API и 1C OData нужны для учета и сверки в своих системах: это смежные интеграции, а не замена приема платежей ЮKassa.
