Документация · Руководство пользователя

Оплата miaPOS на сайте в Lovable

Ваш сайт в Lovable начнёт принимать оплату мгновенным переводом MIA со счетов в банках Молдовы. Писать код не нужно: вы просите Lovable простыми словами, и он сам делает всю техническую часть.

АудиторияТорговец
СложностьБазовый
Обновлено2026-11-19

Что получится

  • Покупатель на компьютере видит QR-код. Он сканирует его приложением своего банка и подтверждает оплату.
  • Покупатель на телефоне выбирает свой банк из списка банков. Открывается приложение банка, там он подтверждает оплату.
  • Деньги приходят на счёт магазина за несколько секунд. Сумма только в MDL.
  • Заказ на сайте сам отмечается оплаченным, когда miaPOS подтверждает платёж. Вручную сверять не нужно.

Вы ни разу не вводите секретный ключ в чат Lovable и не храните его в коде. Ключ лежит в настройках проекта, в разделе Secrets, и в браузер покупателя не попадает.

Что нужно до начала

ЧтоДля тестаДля боевого режима
Проект в Lovable, где покупатель оформляет заказ: корзина, бронь, пожертвованиенужнонужно
Кредиты Lovable на одно большое изменение. В нашем тесте на бесплатном тарифе оно израсходовало дневной лимитнужнонемного, на одно короткое сообщение
Договор с банком на приём оплаты через miaPOSне нужнонужно
Четыре значения подключения от банкане нужнонужно

Для теста ничего у банка просить не надо: Lovable возьмёт публичные тестовые данные miaPOS. Тестовые оплаты проходят без настоящих денег.

Шаг 1. Добавить навык miaPOS в Lovable

Навык, или skill в терминах Lovable, служит ему инструкцией: по ней Lovable знает, как правильно и безопасно подключить miaPOS. Добавляется один раз и дальше работает во всех ваших проектах.

  1. В Lovable откройте Account settings → Personal skills → Import skills.
  2. Вставьте адрес и подтвердите: https://github.com/miapos/claude-plugin/tree/main/skills/miapos-lovable-checkout
  3. В списке навыков появится miapos-lovable-checkout.

Если в Lovable работает команда, администратор может добавить навык сразу для всех: Workspace settings → Skills → Add → Import from GitHub, тот же адрес.

Шаг 2. Попросить Lovable подключить оплату

Откройте свой проект и напишите в чат:

Add payment with miaPOS to my app.

Можно и по-русски или по-румынски, например «Добавь оплату через miaPOS». Главное, назвать miaPOS. Если Lovable предложит Stripe или Shopify, ответьте: «Нет, через miaPOS».

Что сделает Lovable:

  • подключит тестовый режим сам, на публичных тестовых данных miaPOS;
  • добавит кнопку оплаты и страницу заказа, где покупатель видит QR-код или список банков;
  • сделает таблицу платежей, привязанную к заказам;
  • настроит приём уведомлений от miaPOS с проверкой подписи;
  • добавит фоновую проверку раз в минуту, на случай если уведомление не дошло.

Пока сайт работает в тестовом режиме, на странице заказа видна надпись «Test payment, no real money». Такие заказы не выполняйте: денег за ними нет.

Изменение большое, Lovable делает его за один или несколько ходов. Если он остановился на полпути, напишите «Продолжай».

Шаг 3. Опубликовать и проверить тестовым заказом

Проверяйте на опубликованном сайте, а не в окне редактора. Уведомления от miaPOS приходят только на опубликованный адрес: предпросмотр Lovable закрыт для внешних сервисов.

  1. Нажмите Publish в Lovable. Если сайт уже опубликован, нажмите Update, чтобы выложить изменения.
  2. Откройте свой сайт по опубликованному адресу и оформите заказ как покупатель. Данные вводите вымышленные, не настоящие.
  3. Нажмите кнопку оплаты. Появится QR-код. Ничего сканировать не нужно: в тестовом режиме платёж оплачивается сам.
  4. Примерно через 15 секунд страница покажет, что заказ оплачен.
  5. Повторите с телефона. Вместо QR-кода появится список банков. Заказ так же оплатится сам; в приложении банка платить не надо.

Если заказ не стал оплаченным за минуту, напишите в чат Lovable: «Тестовый заказ на опубликованном сайте не стал оплаченным, проверь по навыку miaPOS».

Шаг 4. Включить боевой режим

Боевой режим означает замену четырёх тестовых значений на ваши; код не меняется. Значения выдаёт банк, когда подключает ваш магазин к miaPOS.

Название в SecretsЧто это
MIAPOS_BASE_URLадрес miaPOS вашего банка
MIAPOS_MERCHANT_IDномер вашего магазина в miaPOS
MIAPOS_SECRET_KEYсекретный ключ магазина
MIAPOS_TERMINAL_IDномер терминала для сайта
  1. Введите четыре значения сами в Project Settings → Secrets. Не пишите их в чат Lovable и не пересылайте скриншотом: историю чата видят все участники проекта.
  2. Напишите в чат: «Переведи оплату miaPOS в боевой режим, значения я уже ввёл в Secrets». Lovable проверит приложение по списку из навыка и скажет, что готово.
  3. Удалите тестовые заказы или просто не выполняйте их. Они остаются отмеченными как оплаченные, но денег за ними нет.
  4. Сделайте один настоящий платёж на 1 MDL со своего счёта. Надписи «Test payment, no real money» быть не должно, заказ должен стать оплаченным, деньги должны прийти на счёт магазина.
  5. Откройте ещё один платёж на 1 MDL и не платите. Примерно через 5 минут страница заказа покажет, что срок вышел, и кнопку «Try again». В тестовом режиме это не проверить, потому что там всё оплачивается само.

Делайте этот шаг отдельно от других изменений сайта: так проще понять, что сломалось, если что-то пойдёт не так.

Страница платежей, возвраты, копия проекта

Страница платежей для сотрудников. Lovable делает её, только если в приложении есть вход для сотрудников: без входа список платежей увидел бы любой посетитель. Если вход есть, напишите: «Add the miaPOS payments admin page».

  • Там видны дата, заказ, сумма, статус и банк покупателя.
  • Вверху стоят платежи, которые надо проверить человеку: не та сумма, двойная оплата, успех после отказа. Сверьте такой платёж в miaPOS Merchant Portal и отметьте заказ оплаченным или неоплаченным.
  • У незавершённых платежей есть кнопка «Check now»: она спрашивает статус у miaPOS сразу.

Возвраты делаются в miaPOS Merchant Portal, а не на сайте. Lovable их не строит.

Копия проекта (Remix). В копию не переходит фоновая проверка платежей раз в минуту. Попросите в копии: «Восстанови фоновую проверку платежей miaPOS по навыку». Значения в Secrets тоже не копируются, только названия: введите их заново и опубликуйте копию.

Частые вопросы

ВопросОтвет
Какие платежи принимаются?Мгновенные переводы MIA в MDL со счетов в банках Молдовы. Карты, подписки и запрос оплаты по номеру телефона навык не делает.
Магазин в Румынии?Напишите нам в поддержку: этот навык для Молдовы.
Покупатель оплатил, а заказ не отметился?Фоновая проверка раз в минуту отметит его сама. Если за несколько минут не отметился, проверьте платёж в miaPOS Merchant Portal и напишите нам.
Кредиты Lovable закончились посреди работы?Дождитесь, когда они обновятся, и напишите «Продолжай». Начинать заново не нужно.
Можно просто написать ключ в чат, так быстрее?Нет. Боевые значения вводятся только в Project Settings → Secrets. Если ключ всё же попал в чат, попросите банк выдать новый.
Можно тестировать на настоящих данных покупателей?Нет. В тестовых заказах только вымышленные имя, телефон и адрес.

Помощь: miapos.eu/ru/support. Напишите, на каком шаге остановились и что ответил Lovable. Ключи и данные покупателей в письме не присылайте.