# Creare cod QR (Static, Dinamic)
**POST `/v2/mia/qr`**
Acest endpoint permite generarea unui cod QR de tip Static sau Dynamic, cu diferite opțiuni de configurare privind suma, valabilitatea și integrarea în sistemele comercianților.
#### Parametri de request (body)
| Câmp | Tip | Obligatoriu | Descriere |
| ------------- | ------------------ | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `type` | `string(enum)` | da | Tipul codului QR.
Valori posibile: Static, Dynamic.
• Static: cod QR care poate fi utilizat de mai multe ori (ex: autocolant).
• Dynamic: cod QR care poate fi utilizat o singură dată (ex: terminal POS).
|
| `expiresAt` | `string(datetime)` | da, doar pentru `Dynamic` | Data expirării pentru codul QR de tip Dynamic.
• Valoare minimă: 1 minut
• Valoare maximă: 60 zile
• Format: ISO 8601-1:2019 (ex: "2029-10-22T10:32:28+03:00")
Nu se trimite pentru QR de tip Static.
|
| `amountType` | `string(enum)` | da | Tipul sumei. Valori posibile:
• Fixed – sumă fixă (folosește amount)
• Controlled – sumă variabilă cu limită (amountMin și amountMax)
• Free – disponibil doar pentru QR de tip Static, fără sumă predefinită (clientul introduce suma în aplicația bancară).
|
| `amount` | `number(decimal)` | da pentru `Fixed` și `Controlled` | Suma plătită. Trebuie să respecte: amountMin ≤ amount ≤ amountMax.
• Min: > 0
• Max: 100000
Nu se trimite pentru Free.
|
| `amountMin` | `number(decimal)` | da pentru `Controlled` | Suma minimă permisă.
• Min: > 0
• Max: < amountMax
Nu se trimite pentru Free sau Fixed.
|
| `amountMax` | `number(decimal)` | da pentru `Controlled` | Suma maximă permisă.
• Min: > amountMin
• Max: 100000
Nu se trimite pentru Free sau Fixed.
|
| `currency` | `string(enum)` | da | Moneda în care se va face plata.
Valori posibile: MDL (conform ISO 4217).
|
| `description` | `string(500)` | da | Descrierea comenzii. |
| `orderId` | `string(100)` | nu | ID-ul comenzii din partea comerciantului. |
| `callbackUrl` | `string(1000)` | nu | URL-ul unde comerciantul va primi datele după plata cu succes.
Format: URL HTTPS.
|
| `redirectUrl` | `string(1000)` | nu | URL-ul unde clientul va fi redirecționat după o plată cu succes.
Format: URL HTTPS.
|
| `terminalId` | `string(100)` | nu | ID-ul terminalului, furnizat de bancă. |
#### Request example
```json
{
"type": "Dynamic",
"expiresAt": "2029-10-22T10:32:28+03:00",
"amountType": "Fixed",
"amount": 50.00,
"currency": "MDL",
"description": "Order description",
"orderId": "123",
"callbackUrl": "https://example.com/callback",
"redirectUrl": "https://example.com/success",
"terminalId": "P011111"
}
```
***
#### Parametri de răspuns
| Câmp | Tip | Descriere |
| --------------------- | ------------------ | --------------------------------------------------------------------------- |
| `result.qrId` | `string(guid)` | Identificator unic al codului QR. |
| `result.extensionId` | `string(guid)` | Identificatorul extensiei QR. |
| `result.orderId` | `string(100)` | ID-ul comenzii din partea comerciantului. |
| `result.type` | `string(enum)` | Tipul QR returnat. Valori posibile: `Static`, `Dynamic`, `Hybrid`. |
| `result.url` | `string(1000)` | Linkul QR generat. Format: URL HTTPS. |
| `result.expiresAt` | `string(datetime)` | Data expirării QR-ului (pentru Dynamic sau Hybrid). Format ISO 8601-1:2019. |
| `ok` | `boolean` | Statusul cererii. `true` – fără erori, `false` – cu erori. |
| `errors` | `array` | Lista erorilor (dacă `ok` este `false`). |
| `errors.errorCode` | `string` | Codul erorii. |
| `errors.errorMessage` | `string` | Mesajul erorii. |
#### Response example
```json
{
"result": {
"qrId": "123e4567-e89b-12d3-a456-426614174000",
"extensionId": "40e6ba44-7dff-48cc-91ec-386a38318c68",
"orderId": "123",
"type": "Dynamic",
"url": "https://example.com/qr/123e4567-e89b-12d3-a456-426614174000",
"expiresAt": "2029-10-22T10:32:28+03:00"
},
"ok": true
}
```