Docs · User Guide

miaPOS payments on your Lovable site

Your Lovable site can take payments by MIA instant transfer from bank accounts in Moldova. You write no code: you ask Lovable in plain words, and it builds the technical part.

AudienceMerchant
DifficultyBasic
Updated2026-11-19

What you get

  • A buyer on a computer sees a QR code, scans it with their banking app and confirms the payment.
  • A buyer on a phone picks their bank from the list of banks. Their banking app opens, and they confirm the payment there.
  • The money reaches the shop's account in seconds. Amounts are in MDL only.
  • The order on your site is marked paid by itself once miaPOS confirms the payment. You don't match payments by hand.

You never type the secret key into the Lovable chat and never keep it in the code. It sits in the project settings, under Secrets, and never reaches the buyer's browser.

Before you start

WhatFor testingFor going live
A Lovable project where a buyer places an order: a cart, a booking, a donationyesyes
Lovable credits. Adding payment is a large change: in our test on the Free plan it used up a day's creditsyesa little, for one short message
An agreement with your bank to accept payments through miaPOSnoyes
Four connection values from the banknoyes

For testing you need nothing from the bank: Lovable uses miaPOS's public test values. Test payments move no real money.

Step 1. Add the miaPOS skill to Lovable

A skill is a set of instructions for Lovable: it tells Lovable how to connect miaPOS correctly and safely. You add it once, and it works in all your projects.

  1. In Lovable, open Account settings → Personal skills → Import skills.
  2. Paste this address and confirm: https://github.com/miapos/claude-plugin/tree/main/skills/miapos-lovable-checkout
  3. miapos-lovable-checkout appears in your list of skills.

If you work in Lovable as a team, an admin can add the skill for everyone: Workspace settings → Skills → Add → Import from GitHub, with the same address.

Step 2. Ask Lovable to add payment

Open your project and write in the chat:

Add payment with miaPOS to my app.

You can also write in Romanian or Russian. What matters is that you name miaPOS. If Lovable suggests Stripe or Shopify, answer: "No, with miaPOS."

What Lovable does:

  • sets up test mode by itself, with miaPOS's public test values;
  • adds a pay button and an order page where the buyer sees the QR code or the list of banks;
  • creates a payments table linked to your orders;
  • sets up a route that receives miaPOS notifications and checks their signature;
  • adds a background check every minute, in case a notification does not get through.

While the site runs in test mode, the order page shows "Test payment, no real money". Don't fulfil those orders: no money stands behind them.

This is a large change, and Lovable may need one or several turns for it. If it stops halfway, write "Continue".

Step 3. Publish and pay a test order

Test on the published site, not in the editor window. miaPOS notifications reach only the published address: the Lovable preview is closed to outside services.

  1. Click Publish in Lovable. If the site is already published, click Update to publish the changes.
  2. Open your site at its published address and place an order as a buyer. Use made-up details, not real ones.
  3. Click the pay button. A QR code appears. You don't need to scan it: in test mode the payment pays itself.
  4. After about 15 seconds, the page shows that the order is paid.
  5. Repeat from a phone. Instead of the QR code, a list of banks appears. The order again pays itself; you don't need to pay in the banking app.

If the order isn't paid within a minute, write in the Lovable chat: "The test order on the published site did not get paid, check it against the miaPOS skill."

Step 4. Go live

Going live means replacing the four test values with your own; the code does not change. Your bank gives you the values when it connects your shop to miaPOS.

Name in SecretsWhat it is
MIAPOS_BASE_URLyour bank's miaPOS address
MIAPOS_MERCHANT_IDyour shop's number in miaPOS
MIAPOS_SECRET_KEYyour shop's secret key
MIAPOS_TERMINAL_IDthe terminal number for your site
  1. Enter the four values yourself in Project Settings → Secrets. Don't type them into the Lovable chat and don't send them as a screenshot: everyone in the project can see the chat history.
  2. Write in the chat: "Switch miaPOS payment to production, I have already entered the values in Secrets." Lovable checks the app against the list in the skill and tells you when it is ready.
  3. Delete the test orders, or simply don't fulfil them. They stay marked as paid, but no money stands behind them.
  4. Make one real payment of 1 MDL from your own account. The "Test payment, no real money" label should be gone, the order should turn paid, and the money should reach the shop's account.
  5. Open another 1 MDL payment and don't pay it. After about 5 minutes, the order page shows that it expired and a "Try again" button. You can't check this in test mode, because everything there pays itself.

Do this step on its own, apart from other changes to the site: if something goes wrong, the cause is easier to find.

Payments page, refunds, project copy

Payments page for staff. Lovable builds it only if your app has sign-in for staff: without sign-in, any visitor could see the list of payments. If you have sign-in, write: "Add the miaPOS payments admin page."

  • It shows the date, order, amount, status and the buyer's bank.
  • At the top are the payments a person should check: a wrong amount, a double payment, a success after a failure. Check such a payment in the miaPOS Merchant Portal, then mark the order as paid or unpaid.
  • Unfinished payments have a "Check now" button that asks miaPOS for the status at once.

Refunds are made in the miaPOS Merchant Portal, not on the site. Lovable does not build them.

Project copy (Remix). The background check that runs every minute does not carry over to a copy. In the copy, ask: "Restore the background check of miaPOS payments from the skill." The values in Secrets are not copied either, only their names: enter them again and publish the copy.

Common questions

QuestionAnswer
Which payments are accepted?MIA instant transfers in MDL from bank accounts in Moldova. The skill does not do cards, subscriptions or payment requests to a phone number.
My shop is in Romania?Write to our support: this skill is for Moldova.
The buyer paid, but the order is not marked?The background check that runs every minute catches it by itself. If it is still not marked after a few minutes, check the payment in the miaPOS Merchant Portal and write to us.
Lovable credits ran out halfway?Wait until they renew and write "Continue". You don't need to start over.
Can I type the key into the chat? It's faster.No. Production values go only into Project Settings → Secrets. If a key did end up in the chat, ask your bank for a new one.
Can I test with real buyers' details?No. Test orders take only a made-up name, phone and address.

Help: miapos.eu/en/support. Tell us which step you stopped at and what Lovable answered. Don't send keys or buyers' details in your message.