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
  1. Endpoint-uri
  2. Inițiere plată
  3. Creare cod QR Hibrid

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
}
PreviousCreare cod QR HibridNextAnulare plată

Last updated 2 days ago