maib MIA QR API
RO
RO
  • Overview
    • Specificații tehnice generale
    • Tipuri QR MIA
  • Endpoint-uri
    • Autentificare
      • Obținere token de autentificare
    • Inițiere plată
      • Creare cod QR (Static, Dinamic)
      • Creare cod QR Hibrid
        • Creare extensie pentru codul QR după ID
    • Anulare plată
      • Anulare QR activ (Static, Dinamic)
      • Anulare extensie QR activ (Hibrid)
    • Rambursare plată
      • Rambursare plată efectuată (Refund)
    • Extragere informații (GET)
      • Afișare listă QR-uri cu opțiuni de filtrare
      • Afișare detalii QR după ID
      • Afișare listă plăți cu opțiuni de filtrare
      • Afișare detalii despre plăți după ID
  • Simulare plată (Sandbox)
  • Notificări pe Callback URL
  • Erori
    • Erori API
    • Coduri de stare HTTP
  • Glosar
  • maib e-commerce API
Powered by GitBook
On this page
  • Statusuri QR
  • Parametri relevanți
  • Coduri de stare HTTP
  • Structura răspunsurilor

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.


Cod
Semnificație
Descriere

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.

PreviousCoduri de stare HTTP

Last updated 2 days ago

Coduri de stare HTTP