Интеграция ЮKassa в 2026: полное руководство

📌 Кому подходит ЮKassa

• Интернет-магазины — приём платежей за товары
• SaaS-сервисы — подписки и рекуррентные платежи
• Услуги — оплата консультаций, записей, бронирований
• Маркетплейсы — приём платежей от покупателей
• B2B — оплата по счёту для юридических лиц

📌 Что вы получите

• shopId — идентификатор магазина
• secret_key — секретный ключ для API
• Доступ к API — https://api.yookassa.ru/v3/
• Личный кабинет — управление платежами

POST https://api.yookassa.ru/v3/payments

Body: JSON с суммой, валютой, методом оплаты, confirmation URL

yookassa.widget({ confirmation_token: '...' })

📌 Полный платёжный поток ЮKassa

1. Создание платежа: ваш сервер отправляет POST /v3/payments с суммой, валютой, confirmation URL
2. Получение confirmation_url: ЮKassa возвращает URL для оплаты
3. Перенаправление: пользователь переходит на страницу оплаты ЮKassa
4. Ввод данных карты: пользователь вводит данные или выбирает способ оплаты
5. Авторизация: ЮKassa отправляет запрос в банк-эквайер
6. 3‑D Secure: при необходимости дополнительная проверка
7. Подтверждение: банк подтверждает или отклоняет платёж
8. Webhook уведомление: ЮKassa отправляет POST на ваш webhook URL
9. Обновление статуса: ваш сервер обновляет статус заказа
10. Возврат клиента: клиент возвращается на return_url

📌 Пример создания платежа (PHP)

$client = new \YooKassa\Client();
$client->setAuth($shopId, $secretKey);

$payment = $client->createPayment([
    'amount' => ['value' => '100.00', 'currency' => 'RUB'],
    'confirmation' => ['type' => 'redirect', 'return_url' => 'https://myapp.com/return'],
    'capture' => true,
    'description' => 'Заказ №123',
], uniqid('', true));

header('Location: ' . $payment->getConfirmation()->getConfirmationUrl());

📌 Пример обработчика вебхука

public function handleWebhook(Request $request)
{
    $event = $request->input('event');
    $data = $request->input('object');
    
    // Проверка IP
    if (!in_array($request->ip(), config('yookassa.ips'))) {
        return response('Forbidden', 403);
    }
    
    // Идемпотентность
    $eventId = $request->input('event_id');
    if (ProcessedEvent::where('event_id', $eventId)->exists()) {
        return response('OK', 200);
    }
    
    // Асинхронная обработка
    ProcessPaymentJob::dispatch($event, $data);
    ProcessedEvent::create(['event_id' => $eventId]);
    
    return response('OK', 200);
}

📌 Пример создания подписки

// Первый платёж с сохранением карты
$payment = $client->createPayment([
    'amount' => ['value' => '500.00', 'currency' => 'RUB'],
    'capture' => true,
    'confirmation' => ['type' => 'redirect', 'return_url' => '...'],
    'save_payment_method' => true,
], uniqid('', true));

// После успешной оплаты получаем payment_method_id
$paymentMethodId = $payment->getPaymentMethod()->getId();

// Повторное списание
$recurring = $client->createPayment([
    'amount' => ['value' => '500.00', 'currency' => 'RUB'],
    'capture' => true,
    'payment_method_id' => $paymentMethodId,
], uniqid('', true));

📌 Пример с чеком

$payment = $client->createPayment([
    'amount' => ['value' => '1500.00', 'currency' => 'RUB'],
    'confirmation' => ['type' => 'redirect', 'return_url' => '...'],
    'capture' => true,
    'receipt' => [
        'customer' => ['email' => 'client@example.com'],
        'items' => [
            [
                'description' => 'Товар 1',
                'quantity' => '1.00',
                'amount' => ['value' => '1000.00', 'currency' => 'RUB'],
                'vat_code' => 1,
            ],
            [
                'description' => 'Товар 2',
                'quantity' => '1.00',
                'amount' => ['value' => '500.00', 'currency' => 'RUB'],
                'vat_code' => 1,
            ],
        ],
    ],
], uniqid('', true));

📌 Что вы получаете, заказывая интеграцию ЮKassa у нас

• Регистрацию — помощь с подключением к ЮKassa
• Интеграцию API — создание платежей, статусы, возвраты
• Виджет — встроенная форма оплаты на сайте
• Подписки — рекуррентные платежи через токены
• Чеки 54-ФЗ — автоматическая фискализация
• Вебхуки — безопасная обработка уведомлений
• Поддержку 24/7 — мониторинг, обновления