Оплата miaPOS на сайте в Lovable
Ваш сайт в Lovable начнёт принимать оплату мгновенным переводом MIA со счетов в банках Молдовы. Писать код не нужно: вы просите Lovable простыми словами, и он сам делает всю техническую часть.
Что получится
- Покупатель на компьютере видит QR-код. Он сканирует его приложением своего банка и подтверждает оплату.
- Покупатель на телефоне выбирает свой банк из списка банков. Открывается приложение банка, там он подтверждает оплату.
- Деньги приходят на счёт магазина за несколько секунд. Сумма только в MDL.
- Заказ на сайте сам отмечается оплаченным, когда miaPOS подтверждает платёж. Вручную сверять не нужно.
Вы ни разу не вводите секретный ключ в чат Lovable и не храните его в коде. Ключ лежит в настройках проекта, в разделе Secrets, и в браузер покупателя не попадает.
Что нужно до начала
| Что | Для теста | Для боевого режима |
|---|---|---|
| Проект в Lovable, где покупатель оформляет заказ: корзина, бронь, пожертвование | нужно | нужно |
| Кредиты Lovable на одно большое изменение. В нашем тесте на бесплатном тарифе оно израсходовало дневной лимит | нужно | немного, на одно короткое сообщение |
| Договор с банком на приём оплаты через miaPOS | не нужно | нужно |
| Четыре значения подключения от банка | не нужно | нужно |
Для теста ничего у банка просить не надо: Lovable возьмёт публичные тестовые данные miaPOS. Тестовые оплаты проходят без настоящих денег.
Шаг 1. Добавить навык miaPOS в Lovable
Навык, или skill в терминах Lovable, служит ему инструкцией: по ней Lovable знает, как правильно и безопасно подключить miaPOS. Добавляется один раз и дальше работает во всех ваших проектах.
- В Lovable откройте Account settings → Personal skills → Import skills.
- Вставьте адрес и подтвердите:
https://github.com/miapos/claude-plugin/tree/main/skills/miapos-lovable-checkout - В списке навыков появится 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 закрыт для внешних сервисов.
- Нажмите Publish в Lovable. Если сайт уже опубликован, нажмите Update, чтобы выложить изменения.
- Откройте свой сайт по опубликованному адресу и оформите заказ как покупатель. Данные вводите вымышленные, не настоящие.
- Нажмите кнопку оплаты. Появится QR-код. Ничего сканировать не нужно: в тестовом режиме платёж оплачивается сам.
- Примерно через 15 секунд страница покажет, что заказ оплачен.
- Повторите с телефона. Вместо QR-кода появится список банков. Заказ так же оплатится сам; в приложении банка платить не надо.
Если заказ не стал оплаченным за минуту, напишите в чат Lovable: «Тестовый заказ на опубликованном сайте не стал оплаченным, проверь по навыку miaPOS».
Шаг 4. Включить боевой режим
Боевой режим означает замену четырёх тестовых значений на ваши; код не меняется. Значения выдаёт банк, когда подключает ваш магазин к miaPOS.
| Название в Secrets | Что это |
|---|---|
MIAPOS_BASE_URL | адрес miaPOS вашего банка |
MIAPOS_MERCHANT_ID | номер вашего магазина в miaPOS |
MIAPOS_SECRET_KEY | секретный ключ магазина |
MIAPOS_TERMINAL_ID | номер терминала для сайта |
- Введите четыре значения сами в Project Settings → Secrets. Не пишите их в чат Lovable и не пересылайте скриншотом: историю чата видят все участники проекта.
- Напишите в чат: «Переведи оплату miaPOS в боевой режим, значения я уже ввёл в Secrets». Lovable проверит приложение по списку из навыка и скажет, что готово.
- Удалите тестовые заказы или просто не выполняйте их. Они остаются отмеченными как оплаченные, но денег за ними нет.
- Сделайте один настоящий платёж на 1 MDL со своего счёта. Надписи «Test payment, no real money» быть не должно, заказ должен стать оплаченным, деньги должны прийти на счёт магазина.
- Откройте ещё один платёж на 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. Ключи и данные покупателей в письме не присылайте.