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

{
    "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

{
    "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
}