Plăți miaPOS pe site-ul creat în Lovable
Site-ul pe care l-ați creat în Lovable poate accepta plăți instant MIA din conturile bancare ale clienților din Moldova. Nu trebuie să scrieți cod: îi spuneți lui Lovable ce doriți, cu propriile cuvinte, iar de partea tehnică se ocupă el.
Cum funcționează
- Pe calculator, cumpărătorul vede un cod QR, îl scanează cu aplicația băncii sale și confirmă plata.
- Pe telefon, cumpărătorul își alege banca din lista băncilor. Se deschide aplicația băncii, iar acolo confirmă plata.
- Banii ajung în contul magazinului în câteva secunde. Plățile se fac doar în MDL.
- Comanda se marchează automat ca plătită imediat ce miaPOS confirmă plata. Nu mai trebuie să verificați plățile manual.
Cheia secretă nu se scrie niciodată în chatul Lovable și nu se păstrează în cod. Cheia se salvează în setările proiectului, la Secrets, și nu ajunge în browserul cumpărătorului.
De ce aveți nevoie
| Ce vă trebuie | Pentru test | Pentru plăți reale |
|---|---|---|
| Un proiect Lovable în care clienții comandă sau plătesc: coș de cumpărături, rezervări, donații | da | da |
| Credite Lovable. Integrarea plății este o modificare amplă: în testul nostru, pe planul Free, a consumat toate creditele dintr-o zi | da | câteva, pentru un mesaj scurt |
| Contract cu banca pentru acceptarea plăților prin miaPOS | nu | da |
| Datele de acces de la bancă (patru valori) | nu | da |
Pentru test nu aveți nevoie de nimic de la bancă: Lovable folosește datele publice de test miaPOS. La plățile de test nu se transferă bani reali.
Pasul 1. Adăugați skill-ul miaPOS în Lovable
Skill-ul este un set de instrucțiuni care îi arată lui Lovable cum să conecteze miaPOS corect și în siguranță. Îl adăugați o singură dată, după care funcționează în toate proiectele dumneavoastră.
- În Lovable, deschideți Account settings → Personal skills → Import skills.
- Lipiți adresa de mai jos și confirmați:
https://github.com/miapos/claude-plugin/tree/main/skills/miapos-lovable-checkout - Skill-ul miapos-lovable-checkout apare în listă.
Dacă lucrați în Lovable în echipă, administratorul îl poate adăuga pentru toți membrii: Workspace settings → Skills → Add → Import from GitHub, cu aceeași adresă.
Pasul 2. Cereți-i lui Lovable să adauge plata
Deschideți proiectul și scrieți în chat:
Add payment with miaPOS to my app.
Puteți scrie și în română, de exemplu „Adaugă plata prin miaPOS”. Important este să menționați miaPOS. Dacă Lovable vă propune Stripe sau Shopify, răspundeți: „Nu, prin miaPOS”.
Ce face Lovable:
- activează singur modul de test, cu datele publice de test miaPOS;
- adaugă butonul de plată și pagina comenzii, unde cumpărătorul vede codul QR sau lista băncilor;
- creează un tabel de plăți, legat de comenzi;
- configurează primirea notificărilor de la miaPOS și verificarea semnăturii fiecărei notificări;
- adaugă o verificare automată, o dată pe minut, pentru cazul în care o notificare nu ajunge.
Cât timp site-ul funcționează în modul de test, pe pagina comenzii apare mesajul „Test payment, no real money”. Nu onorați aceste comenzi: nu sunt plătite cu bani reali.
Modificarea este amplă, iar Lovable o poate face într-un singur pas sau în mai mulți pași. Dacă se oprește la jumătate, scrieți „Continuă”.
Pasul 3. Publicați site-ul și faceți o comandă de test
Testați pe site-ul publicat, nu în editor. Notificările miaPOS ajung doar la adresa publicată, iar previzualizarea din Lovable nu poate fi accesată din exterior.
- Apăsați Publish în Lovable. Dacă site-ul este deja publicat, apăsați Update ca să publicați modificările.
- Deschideți site-ul la adresa publicată și plasați o comandă, ca un cumpărător obișnuit. Folosiți date fictive, nu reale.
- Apăsați butonul de plată. Apare codul QR. Nu este nevoie să-l scanați: în modul de test plata se efectuează automat.
- După aproximativ 15 secunde, comanda apare pe pagină ca plătită.
- Repetați de pe telefon. În locul codului QR apare lista băncilor. Și aici plata se face automat, nu trebuie s-o confirmați în aplicația băncii.
Dacă după un minut comanda tot nu apare ca plătită, scrieți în chatul Lovable: „Comanda de test de pe site-ul publicat nu apare ca plătită. Verifică integrarea conform skill-ului miaPOS.”
Pasul 4. Treceți la plăți reale
Pentru plăți reale înlocuiți cele patru valori de test cu valorile dumneavoastră; codul rămâne același. Le primiți de la bancă atunci când aceasta vă conectează magazinul la miaPOS.
| Denumirea în Secrets | Ce reprezintă |
|---|---|
MIAPOS_BASE_URL | adresa miaPOS a băncii dumneavoastră |
MIAPOS_MERCHANT_ID | codul (ID-ul) magazinului în miaPOS |
MIAPOS_SECRET_KEY | cheia secretă a magazinului |
MIAPOS_TERMINAL_ID | codul (ID-ul) terminalului pentru site |
- Introduceți personal cele patru valori în Project Settings → Secrets. Nu le scrieți în chatul Lovable și nu le trimiteți ca captură de ecran: istoricul chatului este vizibil pentru toți membrii proiectului.
- Scrieți în chat: „Treci plata miaPOS în modul de producție. Am introdus deja valorile în Secrets.” Lovable verifică aplicația conform listei din skill și vă anunță când totul este gata.
- Ștergeți comenzile de test sau cel puțin nu le onorați: rămân marcate ca plătite, dar nu au fost achitate cu bani reali.
- Efectuați o plată reală de 1 MDL din contul propriu. Asigurați-vă că mesajul „Test payment, no real money” nu mai apare, că comanda este marcată ca plătită și că banii au ajuns în contul magazinului.
- Începeți încă o plată de 1 MDL, dar nu o confirmați în aplicația băncii. După aproximativ 5 minute, pe pagina comenzii apare mesajul că plata a expirat și butonul „Try again”. În modul de test acest lucru nu poate fi verificat, deoarece în acest mod toate plățile se efectuează automat.
Faceți acest pas separat de alte modificări ale site-ului: dacă apare o problemă, cauza se găsește mai ușor.
Pagina de plăți, rambursări, copia proiectului
Pagina de plăți pentru angajați. Lovable o creează doar dacă site-ul are autentificare pentru angajați: fără ea, lista plăților ar fi vizibilă oricărui vizitator. Dacă autentificarea există, scrieți: „Add the miaPOS payments admin page”.
- Pe pagină se văd data, comanda, suma, statusul și banca cumpărătorului.
- În partea de sus apar plățile care trebuie verificate manual: sumă greșită, plată dublă, plată reușită după un refuz. Verificați o astfel de plată în miaPOS Merchant Portal și marcați comanda ca plătită sau neplătită.
- Pentru plățile nefinalizate există butonul „Check now”, care cere imediat statusul plății de la miaPOS.
Rambursările se fac din miaPOS Merchant Portal; Lovable nu le adaugă pe site.
Copia proiectului (Remix). Verificarea automată a plăților, care se face o dată pe minut, nu se copiază. În copie, cereți: „Restabilește verificarea automată a plăților miaPOS conform skill-ului”. Nici valorile din Secrets nu se copiază, doar denumirile lor: introduceți din nou valorile, apoi publicați copia.
Întrebări frecvente
| Întrebare | Răspuns |
|---|---|
| Ce plăți se acceptă? | Plăți instant MIA, în MDL, din conturi bancare din Moldova. Plățile cu cardul, abonamentele și solicitările de plată după numărul de telefon nu sunt incluse în acest skill. |
| Funcționează și pentru un magazin din România? | Scrieți-ne la suport: acest skill este destinat Moldovei. |
| Cumpărătorul a plătit, dar comanda nu apare ca plătită? | Verificarea automată, care se face o dată pe minut, o va actualiza. Dacă după câteva minute statusul tot nu s-a schimbat, verificați plata în miaPOS Merchant Portal și scrieți-ne. |
| S-au terminat creditele Lovable la jumătatea lucrului? | Așteptați până se reînnoiesc și scrieți „Continuă”. Nu e nevoie să o luați de la capăt. |
| Pot scrie cheia în chat, ca să fie mai repede? | Nu. Datele pentru plăți reale se introduc doar în Project Settings → Secrets. Dacă totuși cheia a ajuns în chat, cereți băncii o cheie nouă. |
| Pot face teste cu datele reale ale clienților? | Nu. În comenzile de test folosiți doar nume, telefon și adresă fictive. |
Ajutor: miapos.eu/ro/support. Indicați pasul la care v-ați oprit și ce v-a răspuns Lovable. Nu includeți în mesaj cheile sau datele clienților.