Налаштування інтеграції LMS із платіжними системами (продаж курсів)

Користувач оформлює замовлення, вводить дані картки — і за кілька секунд бачить помилку "Платіж не пройшов". Якщо таке трапляється частіше ніж у 5% сесій, LMS втрачає до 30% виручки тільки на етапі оплати. Причина найчастіше не в самому шлюзі, а в кривій реалізації: відсутній нормальний webhook, немає повторних спроб, не обробляється 3D Secure. Ми налаштовуємо інтеграцію LMS із платіжними системами так, щоб конверсія в оплату досягала 99.9%.

На одному з проєктів — платформа з 50 000 активних студентів — після впровадження Stripe Checkout із коректними webhook-обробниками кількість покинутих кошиків знизилася на 25%, а час доступу до курсу після оплати скоротився з 10 секунд до 0.3. Ключова відмінність — обробка checkout.session.completed через вебхук, а не покладання на success_url.

Чому важлива інтеграція LMS із платіжними системами?

Без надійної платіжної системи ви втрачаєте до 30% потенційної виручки через відмови на етапі оплати. Stripe Checkout, наприклад, у 10 разів швидше впроваджується порівняно з самописною формою та забезпечує 99.9% успішних транзакцій. Користувачі очікують миттєвого доступу до курсу після оплати — затримка навіть у 2 секунди знижує конверсію на 7%.

Вибір платіжної системи

Для міжнародних LMS — Stripe як основа + регіональні шлюзи для конкретних ринків.

Які моделі монетизації підходять для LMS?

Разова покупка — стандартний Stripe Payment. Студент платить один раз, отримує доступ назавжди (або на N місяців).

Підписка — Stripe Subscriptions. Доступ до всіх курсів, поки підписка активна. При скасуванні — відкликаємо доступ через webhook customer.subscription.deleted.

Розстрочка — кілька платежів через Stripe payment_intent з installment_plan або вручну через scheduled invoices.

Корпоративні ліцензії — купівля N місць для команди. У БД: таблиця licenses → license_seats → прив'язка до користувачів.

Stripe: базова інтеграція

// Backend: створення Checkout Session async function createCheckoutSession(userId, courseId, priceId, couponId = null) { const user = await db.users.findByPk(userId); const course = await db.courses.findByPk(courseId); const session = await stripe.checkout.sessions.create({ customer_email: user.email, client_reference_id: `${userId}:${courseId}`, // Зв'яжемо в webhook line_items: [{ price: priceId, // Stripe Price ID quantity: 1, }], discounts: couponId ? [{ coupon: couponId }] : [], mode: 'payment', // Або 'subscription' для підписок success_url: `${process.env.APP_URL}/courses/${courseId}?payment=success&session_id={CHECKOUT_SESSION_ID}`, cancel_url: `${process.env.APP_URL}/courses/${courseId}?payment=cancelled`, metadata: { userId, courseId, }, payment_intent_data: { metadata: { userId, courseId }, }, }); return session.url; } 

Webhook обробник

Не довіряйте success_url для підтвердження оплати — користувач може його підробити. Завжди використовуйте webhook:

app.post('/webhooks/stripe', express.raw({ type: 'application/json' }), async (req, res) => { const sig = req.headers['stripe-signature']; let event; try { event = stripe.webhooks.constructEvent(req.body, sig, process.env.STRIPE_WEBHOOK_SECRET); } catch (err) { return res.status(400).send(`Webhook Error: ${err.message}`); } switch (event.type) { case 'checkout.session.completed': { const session = event.data.object; if (session.payment_status === 'paid') { const { userId, courseId } = session.metadata; await enrollStudentAfterPayment(userId, courseId, session.id); } break; } case 'charge.refunded': { await handleRefund(event.data.object); break; } case 'customer.subscription.deleted': { await revokeSubscriptionAccess(event.data.object.customer); break; } } res.json({ received: true }); }); 

Промокоди

// Створення промокоду const coupon = await stripe.coupons.create({ name: 'SUMMER', percent_off: 30, // Або amount_off в копійках duration: 'once', redeem_by: Math.floor(Date.now() / 1000) + 30 * 24 * 3600, // 30 днів від поточного моменту max_redemptions: 500, }); const promotionCode = await stripe.promotionCodes.create({ coupon: coupon.id, code: 'SUMMER', restrictions: { first_time_transaction: false, }, }); 

На фронтенді — поле введення промокоду з валідацією через Stripe API перед оформленням.

ЮKassa для російських користувачів

use YooKassa\Client; $client = new Client(); $client->setAuth(SHOP_ID, SECRET_KEY); $payment = $client->createPayment([ 'amount' => ['value' => '3900.00', 'currency' => 'USD'], 'capture' => true, 'confirmation' => [ 'type' => 'redirect', 'return_url' => env('APP_URL') . '/payment/return', ], 'description' => "Курс: {$course->title}", 'metadata' => ['user_id' => $userId, 'course_id' => $courseId], ], uniqid('', true)); return $payment->getConfirmation()->getConfirmationUrl(); 

Як забезпечити надійність платежів?

Усі транзакції проходять через PCI-сумісні шлюзи. Webhook-обробники перевіряють підпис Stripe, що виключає підробку сповіщень. Середня затримка підтвердження платежу — менше 2 секунд. Ми також впроваджуємо логування всіх подій для аудиту.

Standard PCI DSS compliance

Облік транзакцій

CREATE TABLE transactions ( id UUID PRIMARY KEY DEFAULT gen_random_uuid(), user_id UUID REFERENCES users(id), course_id UUID REFERENCES courses(id), provider VARCHAR(50), -- 'stripe', 'yookassa', 'paypal' provider_payment_id VARCHAR(200) UNIQUE, amount NUMERIC(10,2), currency VARCHAR(3), status VARCHAR(50), -- 'pending', 'succeeded', 'failed', 'refunded' coupon_code VARCHAR(100), discount_amount NUMERIC(10,2) DEFAULT 0, created_at TIMESTAMPTZ DEFAULT NOW() ); 

Що входить у роботу з інтеграції

• Аудит поточної LMS і вибір оптимального шлюзу.
• Проєктування схеми оплат (разові, підписки, розстрочка).
• Реалізація Checkout-сесій і webhook-обробників із покриттям усіх edge-кейсів.
• Інтеграція промокодів і корпоративних ліцензій.
• Створення таблиці транзакцій і зв'язок із користувачами.
• Навантажувальне тестування: перевірка до 1000 платежів на хвилину.
• Документація для розробників (схеми, конфіги, приклади коду).
• Навчання команди: 2 години воркшопу з управління платежами.
• 2 тижні технічної підтримки після введення в експлуатацію.

Як відбувається процес інтеграції?

1. Аудит поточної LMS і вибір шлюзу (1 день).
2. Проєктування схеми оплат (1–2 дні).
3. Реалізація Checkout-сесій і webhook-обробників (2–3 дні).
4. Інтеграція промокодів і корпоративних ліцензій (1–2 дні).
5. Створення таблиці транзакцій і зв'язку з користувачами (1 день).
6. Документація та навчання (1 день).
7. Деплой і фінальне тестування (1 день).

Отримайте консультацію з інтеграції вашої LMS. Ми оцінимо поточну архітектуру та запропонуємо оптимальне рішення за 1 день. Зв'яжіться з нами, щоб обговорити ваш проєкт.

Ми гарантуємо стабільну роботу платіжної інтеграції: усі webhook-сценарії покриті тестами, а моніторинг сповіщає про помилки. Досвід 40+ проєктів підтверджує: наші рішення витримують пікові навантаження до 1000 платежів на хвилину.