Creare extensie pentru codul QR după ID

POST /v2/mia/qr/{qrId}/extension

Permite extinderea valabilității și/sau modificarea sumei pentru un QR Hibrid existent. Este util în cazul în care un QR trebuie reutilizat pentru o nouă comandă sau are nevoie de o nouă perioadă de valabilitate.


Parametri de intrare (body)

Parametru
Tip
Obligatoriu
Descriere

expiresAt

string (datetime)

da

Noua dată de expirare a QR-ului. Trebuie să respecte: minim 1 minut, maxim 60 zile de la momentul curent.

(min>0 / max=100000) Format ISO 8601 (ex: "2029-10-22T10:32:28+03:00").

amount

number (decimal)

da, pentru Fixed sau Controlled

Suma plății. Trebuie să respecte limitele: amountMin <= amount <= amountMax. Nu este permis pentru Free.

amountMin

number (decimal)

da, pentru Controlled

Suma minimă pentru plată. Nu este permis pentru Fixed sau Free.

amountMax

number (decimal)

da, pentru Controlled

Suma maximă pentru plată. Nu este permis pentru Fixed sau Free.

description

string (max 500)

da

Descrierea comenzii.

orderId

string (max 100)

nu

ID-ul comenzii din partea comerciantului.

callbackUrl

string (max 1000)

nu

URL-ul pentru notificare după plată. Format: HTTPS.

redirectUrl

string (max 1000)

nu

URL-ul către care clientul este redirecționat după plată. Format: HTTPS.

Request example

{
  "expiresAt": "2029-11-22T10:32:28+03:00",
  "amount": 100.00,
  "description": "Updated order description",
  "orderId": "456",
  "callbackUrl": "https://example.com/callback",
  "redirectUrl": "https://example.com/success"
}

Răspuns (200 OK)

Parametru
Tip
Descriere

result

object

Obiectul de răspuns.

result.extensionId

string (guid)

ID-ul extensiei adăugate.

ok

boolean

true dacă cererea a fost procesată cu succes, false în caz contrar.

errors

array

Lista erorilor, dacă există.

errors.errorCode

string

Codul erorii.

errors.errorMessage

string

Descrierea erorii.


Response example

{
  "result": {
    "extensionId": "fe7e93a2-d5f2-4e7f-81a3-3c7d17c224f2"
  },
  "ok": true
}

Last updated