# 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.

***

### [Coduri de stare HTTP](#coduri-de-stare-http)

| 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.maibmerchants.md/mia-qr-api/glosar.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.