Specificații tehnice generale

Structura cererilor

Toate interacțiunile cu API-ul se realizează prin cereri HTTPS, cu date în format JSON. Răspunsurile sunt de asemenea returnate în format JSON.

Baze URL disponibile

Mediu	URL bază
PROD	https://api.maibmerchants.md
TEST (Sandbox)	https://sandbox.maibmerchants.md

Este recomandat ca testarea inițială să fie realizată în mediu sandbox, înainte de solicitarea accesului în mediu de producție.

Pentru a trece cu succes testarea integrării API QR MIA, este necesară urmărirea etapelor, care includ obținerea datelor de acces, autentificarea, generarea codurilor QR, gestionarea notificărilor și validarea răspunsurilor API.

Autentificare

Autentificarea se realizează prin intermediul unui token de tip Bearer, obținut în prealabil.

Token-ul se transmite în antetul fiecărei cereri:

cssCopyEditAuthorization-> Authorization

Pentru detalii privind obținerea token-ului, se poate consulta secțiunea Autentificare.

Formatul datelor

• Format acceptat: application/json

• Câmpurile de tip datetime trebuie să fie în formatul ISO 8601 (exemplu: 2029-10-22T10:32:28)

• Moneda utilizată este MDL (Leul Moldovenesc)

Coduri de răspuns HTTP

Pentru lista completă a codurilor de răspuns HTTP accesați secțiunea Coduri de stare HTTP.

Cod	Semnificație
200	Cerere validă, răspuns returnat
400	Cerere invalidă (eroare de structură sau date)
401	Neautorizat (token lipsă sau invalid)
403	Acces interzis (drepturi insuficiente)
500	Eroare internă a serverului