Simulare plată (Sandbox)

POST/v2/mia/test-pay

Simularea plății este permisă exclusiv în mediul sandbox (testare). Acest endpoint permite testarea procesului de plată prin transmiterea unui payload cu detalii despre plată.

---

Cerere (Request)

Metodă: POST

URL: /v2/mia/test-pay

---

Parametrii cerere (body JSON)

Parametru	Tip	Obligatoriu	Descriere
qrId	string (guid)	Da	Identificatorul unic al codului QR
amount	number (decimal)	Da	Suma plății
iban	string(100)	Da	IBAN-ul plătitorului
currency	string (enum)	Da	Moneda plății (valori posibile: MDL)
payerName	string(200)	Da	Numele abreviat al plătitorului

Request example

{
  "qrId": "123e4567-e89b-12d3-a456-426614174000",
  "amount": 10,
  "iban": "MD88AG000000011621810140",
  "currency": "MDL",
  "payerName": "John D."
}

---

Parametri de răspuns (Response parameters)

result

Tip: object Obiectul care conține rezultatul răspunsului.

---

Câmpuri ale obiectului result

Câmp	Tip	Descriere
qrId	string(guid)	Identificatorul unic al codului QR.
qrStatus	string(enum)	Starea codului QR. Valori posibile: Active, Inactive, Expired, Paid, Cancelled.
		- Active – Stare pentru un cod QR activ.
		- Inactive – Stare pentru QR Static sau Hibrid dacă nu a fost efectuată nicio plată în ultimele 30 de zile.
		- Expired – Stare pentru QR Dinamic sau Hibrid dacă perioada de valabilitate a expirat și nu a fost efectuată nicio plată.
		- Paid – Stare pentru QR Dinamic sau Hibrid după ce o plată a fost efectuată.
		- Cancelled – Stare după solicitarea de anulare (POST /v2/mia/qr/{qrId}/cancel).
orderId	string(100)	Identificatorul comenzii de pe partea comerciantului.
payId	string(guid)	Identificatorul unic al plății.
amount	number(decimal)	Suma plății.
commission	number(decimal)	Comisionul perceput pentru plată.
currency	string(enum)	Moneda în care a fost efectuată plata. Valori posibile: MDL. Format: ISO 4217.
payerName	string(200)	Numele prescurtat al plătitorului.
payerIban	string(100)	IBAN-ul plătitorului (International Bank Account Number).
executedAt	string(datetime)	Data și ora la care a fost executată plata. Format: ISO 8601-1:2019.
signatureKey	string	Cheia semnăturii de validare a notificării.

---

Alte câmpuri de răspuns

Câmp	Tip	Descriere
ok	boolean	Statusul procesării cererii. true – fără erori; false – a apărut o eroare (detalii în errors).
errors	array	Lista erorilor întâmpinate în procesarea cererii.

Obiecte în errors

Câmp	Tip	Descriere
errorCode	string	Codul erorii.
errorMessage	string	Descrierea erorii.

Response example

{
  "result": {
    "qrId": "123e4567-e89b-12d3-a456-426614174000",
    "qrStatus": "Active",
    "orderId": "123",
    "payId": "6d24e4a5-c6bf-4d3e-bf7a-8d2123faf4e9",
    "amount": 10,
    "commission": 2.50,
    "currency": "MDL",
    "payerName": "John D.",
    "payerIban": "MD88AG000000011621810140",
    "executedAt": "2024-11-29T10:56:52.1380956+00:00",
    "signatureKey": "592b6999-fdd0-4fd3-9708-5cb9df590dee"
  },
  "ok": true
}

---

Note

• Endpoint-ul este disponibil doar în mediul sandbox pentru testare.

• În cazul în care ok este false, câmpul errors va conține detalii despre erori.

• Valoarea qrStatus reflectă starea actuală a codului QR după simularea plății.

• Verificarea cheii semnăturii din câmpul result.signatureKey trebuie făcută conform algoritmului definit în documentația de notificări (callback).