Glosar
QR MIA – sistemul maib pentru generarea, gestionarea și procesarea plăților prin coduri QR (static, dinamic, hibrid), destinat comercianților care doresc o soluție rapidă, fără redirecționări, pentru încasarea plăților.
QR Code – cod generat în cadrul API-ului QR MIA care conține informațiile necesare pentru inițierea unei plăți. Poate fi Static, Dinamic sau Hibrid, în funcție de contextul și scopul utilizării.
Static QR – cod QR care conține doar date fixe, fără sumă sau detalii personalizate. Util pentru plăți repetate fără valoare prestabilită (ex: donații).
Dynamic QR – cod QR generat cu un scop precis, o singură dată, care include detalii specifice despre tranzacție (sumă, client, etc.).
Hybrid QR – combinație între static și dynamic. Poate fi folosit atât pentru plăți unice, cât și repetate.
qrId – identificatorul unic al QR-ului generat, de tip UUID. Este folosit pentru referință în toate apelurile către API.
PayId – identificatorul unic al plății efectuate sub un QR. Este returnat în răspunsul la plată și utilizat pentru urmărirea tranzacției.
Sandbox – mediu de testare securizat unde pot fi simulate plăți fără a implica fonduri reale. Este destinat testării integrării aplicației comercianților.
Producție (Production) – mediu real unde tranzacțiile au loc cu fonduri reale, destinat comercianților activi.
Executat (executedAt) – momentul în care plata a fost finalizată. Este returnat în format ISO 8601.
Statusuri QR
Active – QR activ și disponibil pentru plată.
Inactive – QR static sau hibrid care nu a fost folosit timp de 30 zile.
Expired – QR dinamic sau hibrid care și-a depășit perioada de valabilitate fără să fie folosit.
Paid – plată efectuată cu succes pentru acel QR.
Cancelled – QR anulat prin endpoint-ul dedicat /cancel
.
Parametri relevanți
iban – contul IBAN al plătitorului, utilizat pentru identificarea acestuia în cadrul tranzacției.
payerName – numele prescurtat al plătitorului, necesar pentru identificare și trasabilitate.
currency – moneda în care se efectuează plata. În prezent, se acceptă doar MDL
.
amount – suma tranzacționată. Se exprimă ca număr zecimal.
200
OK
Request-ul a fost procesat cu succes.
400
Bad Request
Parametrii trimiși în request sunt invalizi sau lipsesc. Verificați formatul și câmpurile obligatorii.
401
Unauthorized
Token-ul de autentificare este absent, expirat sau incorect.
403
Forbidden
Accesul la resursa este interzis. Pot exista restricții de IP sau de permisiuni.
404
Not Found
Resursa solicitată nu a fost găsită (ex: qrId inexistent).
500
Internal Server Error
O eroare internă s-a produs pe server. Încercați din nou mai târziu sau contactați echipa de suport.
Structura răspunsurilor
ok – indică dacă operațiunea a fost procesată cu succes (true
) sau a apărut o eroare (false
).
errors – listă de erori întâlnite în procesarea request-ului.
errors.errorCode – cod unic al erorii (ex: ERR_QR_NOT_FOUND
).
errors.errorMessage – descriere detaliată a problemei apărute.
Last updated