DOCUMENTAȚIE
Integrare E-Commerce
Adăugați plăți instantanee QR în magazinul dvs. online cu API-ul și SDK-ul nostru. De la sandbox la producție în câteva minute.
ÎNCEPEȚI ÎN 5 PAȘI
De la chei API la plăți live
1
Obțineți cheile API
Preluați datele de acces API din Portalul Comerciantului.
2
Integrați SDK
Adăugați SDK-ul JavaScript miaPOS sau utilizați direct API-ul REST.
3
Testați în sandbox
Validați integrarea în mediul sandbox.
4
Lansați live
Treceți la datele de producție și activați plățile reale.
5
Acceptați plăți!
Clienții plătesc prin cod QR direct pe pagina de checkout.
PASUL 1
Obțineți cheile API
Autentificați-vă în Portalul Comerciantului și navigați la secțiunea Plăți Online. Aici veți găsi cheia API și secretul pentru mediile sandbox și producție. Păstrați cheia secretă în siguranță și nu o expuneți niciodată în codul client-side. Fiecare magazin din contul dvs. poate avea propriul set de date de acces.
PASUL 2
Integrați SDK-ul
Adăugați SDK-ul JavaScript miaPOS pe pagina de checkout sau integrați direct prin API-ul REST din backend-ul dvs. SDK-ul gestionează randarea codului QR, verificarea stării plății și notificările callback. Pentru integrări personalizate, API-ul oferă endpoint-uri pentru crearea sesiunilor de plată, verificarea stării și procesarea rambursărilor.
PASUL 3
Testați în sandbox
Utilizați mediul sandbox pentru a testa integrarea fără a procesa bani reali. Sandbox-ul simulează fluxul complet de plată, inclusiv generarea QR, scanarea de către client și notificările callback de confirmare a plății. Verificați că handler-ul webhook procesează corect notificările de succes și eșec înainte de a trece live.
PASUL 4
Lansați live
După finalizarea testării, comutați datele de acces API de la sandbox la producție în Portalul Comerciantului. Actualizați configurația pentru a utiliza endpoint-ul de producție. Nu sunt necesare modificări de cod dacă ați urmat documentația SDK -- doar schimbați cheile și URL-ul de bază.
PASUL 5
Acceptați plăți!
Magazinul dvs. online este acum live cu plăți miaPOS. Clienții văd un cod QR la checkout, îl scanează cu aplicația bancară și confirmă plata. Primiți o notificare webhook în timp real, iar tranzacția apare în Portalul Comerciantului cu toate detaliile. Monitorizați operațiunile online din secțiunea dedicată a tabloului de bord.
Întrebări frecvente
Ce platforme și limbaje sunt suportate?
SDK-ul JavaScript funcționează cu orice frontend web. API-ul REST poate fi apelat din orice limbaj backend (PHP, Python, Node.js, Java, etc.). Oferim exemple de cod și colecții Postman în documentația pentru dezvoltatori.
Cum funcționează rambursările pentru plățile online?
Puteți iniția rambursări din Portalul Comerciantului sau prin API. Sunt suportate rambursări totale și parțiale. Rambursările sunt procesate înapoi în metoda de plată originală a clientului în termen de o zi lucrătoare.
Există o limită de tranzacție pentru plățile online?
Limitele de tranzacție depind de acordul dvs. de comerciant cu banca achizitoare. Limitele implicite sunt de obicei stabilite în timpul onboarding-ului. Contactați banca dvs. pentru a revizui sau ajusta limitele.
Pot folosi plăți E-Commerce și POS cu același cont?
Da. Contul dvs. de comerciant miaPOS suportă toate canalele de plată: POS, SoftPOS, E-Commerce, miaLINKS și Request to Pay. Toate tranzacțiile sunt consolidate într-un singur tablou de bord al Portalului Comerciantului.
Pregătit să integrați plățile online?
Obțineți cheile API, explorați documentația și începeți testarea astăzi.
Deschideți Portalul Comerciantului